Generates cryptographically secure pseudo-random bytes

Descrierea

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.

Sursele de valori aleatorii utilizate pentru această funcție sunt următoarele:

Pe Windows se va utiliza întotdeauna » CryptGenRandom().
Pe Linux se va utiliza apelul de sistem (syscall) » getrandom(2) dacă este disponibil.
Pe alte platforme se va utiliza /dev/urandom.
Dacă nici una din sursele menționate nu sunt disponibile, va fi emisă o excepție Exception.

Notă: Cu toate că această funcție a fost adăugată în PHP 7.0, o » implementare în spațiul utilizatorului este disponibilă pentru PHP de la versiunea 5.2 până la 5.6 inclusiv.

Parametri

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

Valorile întoarse

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

Erori/Excepții

Dacă nu poate fi găsită o sursă potrivită de valori aleatorii, va fi emisă o excepție Exception.
Dacă sunt furnizați parametri incorecți, va fi emisă o excepție TypeError.
If an invalid length of bytes is given, an Error will be thrown.

Exemple

Example #1 random_bytes() example


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

Exemplul de mai sus va afișa ceva similar cu:

string(10) "385e33f741"

A se vedea și

random_int() - Generates cryptographically secure pseudo-random integers
openssl_random_pseudo_bytes() - Generate a pseudo-random string of bytes
bin2hex() - Convert binary data into hexadecimal representation