openssl_random_pseudo_bytes
Generate a pseudo-random string of bytes
&reftitle.description;
stringopenssl_random_pseudo_bytes
intlength
boolstrong_result&null;
Generates a string of pseudo-random bytes, with the number of bytes
determined by the length parameter.
It also indicates if a cryptographically strong algorithm was used to produce the
pseudo-random bytes, and does this via the optional strong_result
parameter. It's rare for this to be &false;, but some systems may be broken or old.
&reftitle.parameters;
length
The length of the desired string of bytes. Must be a positive integer less than or equal to 2147483647. PHP will
try to cast this parameter to a non-null integer to use it.
strong_result
If passed into the function, this will hold a bool value that determines
if the algorithm used was "cryptographically strong", e.g., safe for usage with GPG,
passwords, etc. &true; if it did, otherwise &false;
&reftitle.returnvalues;
Returns the generated &string; of bytes.
&reftitle.errors;
openssl_random_pseudo_bytes throws an Exception
on failure.
&reftitle.changelog;
&Version;
&Description;
8.0.0
strong_result is nullable now.
7.4.0
The function no longer returns &false; on failure, but throws an Exception instead.
&reftitle.examples;
openssl_random_pseudo_bytes example
]]>
&example.outputs.similar;
&reftitle.seealso;
random_bytes
bin2hex
crypt
random_int