Generates cryptographically secure pseudo-random bytes

Description

string random_bytes ( int $length )

Generates an arbitrary length string of cryptographic random bytes that are suitable for cryptographic use, such as when generating salts, keys or initialization vectors.

La source des données aléatoires utilisée pour cette fonction est :

Sous Windows, » CryptGenRandom() sera toujours utilisé.
Sous les autres plate-formes, arc4random_buf() sera utilisé s'il est disponible, ce qui est générallement le cas sur les systèmes dérivés de BSD ou les systèmes possédant libbsd.
Sinon, un appel système Linux » getrandom(2) sera utilisé si disponible.
Si tout ce qui précède n'est pas possible, alors /dev/urandom sera utilisé.
Si tout ce qui précède n'est pas disponible, alors une Exception sera émise.

Note: Although this function was added to PHP in PHP 7.0, a » userland implementation is available for PHP 5.2 to 5.6, inclusive.

Liste de paramètres

length: The length of the random string that should be returned in bytes.

Valeurs de retour

Returns a string containing the requested number of cryptographically secure random bytes.

Erreurs / Exceptions

Si aucune source de données aléatoires n'est trouvée, une Exception sera émise.
Si un paramètre invalide est fourni, une exception de type TypeError sera émise.
If an invalid length of bytes is given, an Error will be thrown.

Exemples

Exemple #1 random_bytes() example


<?php
$bytes = random_bytes(5);
var_dump(bin2hex($bytes));
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

string(10) "385e33f741"

Voir aussi

random_int() - Generates cryptographically secure pseudo-random integers
openssl_random_pseudo_bytes() - Génère une chaine pseudo-aléatoire d'octets
bin2hex() - Convertit des données binaires en représentation hexadécimale