Random\Engine\Secure::generate
En esta página
Random\Engine\Secure::generate
Genera datos aleatorios de manera criptográficamente segura
Descripción#
php
public Random\Engine\Secure::generate(): stringphp
Devuelve datos aleatorios de manera criptográficamente segura.
Las fuentes de aleatoriedad por orden de prioridad son las siguientes:
-
Linux: getrandom(),
/dev/urandom -
FreeBSD >= 12 (PHP >= 7.3): getrandom(),
/dev/urandom -
Windows (PHP >= 7.2): CNG-API
Windows: CryptGenRandom
- macOS (PHP >= 8.2; >= 8.1.9; >= 8.0.22 si CCRandomGenerateBytes está disponible en el momento de la compilación): CCRandomGenerateBytes()
macOS (PHP >= 8.1; >= 8.0.2): arc4random_buf(), /dev/urandom
-
NetBSD >= 7 (PHP >= 7.1; >= 7.0.1): arc4random_buf(),
/dev/urandom -
OpenBSD >= 5.5 (PHP >= 7.1; >= 7.0.1): arc4random_buf(),
/dev/urandom -
DragonflyBSD (PHP >= 8.1): getrandom(),
/dev/urandom -
Solaris (PHP >= 8.1): getrandom(),
/dev/urandom -
Cualquier combinación de un sistema operativo y una versión de PHP no mencionada anteriormente:
/dev/urandom. -
Si ninguna de las fuentes de aleatoriedad está disponible o todas fallan al generar aleatoriedad, se lanzará una excepción de tipo
Random\RandomException.
Parámetros#
Esta función no contiene ningún parámetro.
Valores devueltos#
Una string que contiene PHP_INT_SIZE bytes de aleatoriedad criptográficamente segura.
Errores/Excepciones#
- Si no se encuentra ninguna fuente de datos aleatorios, se lanzará una
Random\RandomException.