Random\Engine\Secure::generate

(PHP 8 >= 8.2.0)

Random\Engine\Secure::generate — Generate cryptographically secure randomness

public Random\Engine\Secure::generate(): string

Returns cryptographically secure randomness.

The sources of randomness used for this function are as follows:

On Windows, » CryptGenRandom() will always be used. As of PHP 7.2.0, the » CNG-API will always be used instead.
On Linux, the » getrandom(2) syscall will be used if available.
On other platforms, /dev/urandom will be used.
If none of the aforementioned sources are available, then a Random\RandomException will be thrown.

This function has no parameters.

A string containing PHP_INT_SIZE cryptographically secure random bytes.

If an appropriate source of randomness cannot be found, a Random\RandomException will be thrown.

Example #1 Random\Engine\Secure::generate() example


<?php

/* ... */

?>

The above example will output something similar to:

...