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 Linux, l'appel système » getrandom(2) sera utilisé si disponible.
Sous les autres plate-formes, /dev/urandom sera utilisé.
Si tout ce qui précède n'est pas disponible, alors une Exception sera émise.

Note: Bien que cette fonction ait été ajoutée en PHP 7.0, une » implementation en espace utilisateur est disponible pour PHP 5.2 jusqu'à 5.6, inclus.

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