(PHP 8 >= 8.2.0)
Random\Engine::generate — Genera aleatoriedad
Retorna aleatoriedad y avanza el estado del algoritmo en un paso.
La aleatoriedad está representada por una cadena binaria que contiene octetos aleatorios. Esta representación permite interpretar sin ambigüedad los bits aleatorios generados por el algoritmo, por ejemplo para tener en cuenta los diferentes tamaños de salida utilizados por los distintos algoritmos.
Los algoritmos que operan nativamente sobre valores enteros deben retornar el entero con los octetos en orden
little-endian, por ejemplo utilizando la función pack() con el código de formato
P. La interfaz de alto nivel proporcionada por el
Random\Randomizer interpretará los octetos aleatorios retornados como enteros no signados
little-endian si se requiere una representación numérica.
Se recomienda encarecidamente que cada bit de la cadena retornada sea seleccionado de manera uniforme e independiente, ya que ciertas aplicaciones requieren aleatoriedad a nivel de bits para funcionar correctamente. Por ejemplo, los generadores congruenciales lineales generan a menudo aleatoriedad de menor calidad para los bits de menor peso del valor entero retornado y por lo tanto no serían adecuados para aplicaciones que requieren aleatoriedad a nivel de bits.
Esta función no tiene parámetros.
Una cadena no vacía que contiene octetos aleatorios.
Nota: El Random\Randomizer utiliza internamente enteros no signados de 64 bits. Si la cadena retornada contiene más de 64 bits (8 octetos) de aleatoriedad, los octetos excedentes serán ignorados. Otras aplicaciones pueden ser capaces de procesar más de 64 bits a la vez.
Ejemplo #1 Ejemplo de Random\Engine::generate()
<?php
/**
* Implementa un Generador Congruencial Lineal con módulo 65536,
* un multiplicador de 61 y un incremento de 17, retornando un entero de 8 bits.
*
* Nota: Este motor solo puede ser utilizado con fines de demostración.
* Los generadores congruenciales lineales generalmente
* generan aleatoriedad de baja calidad y esta implementación específica tiene
* un período muy corto de 16 bits que no es adecuado para
* casi todos los casos de uso en el mundo real.
*/
final class LinearCongruentialGenerator implements \Random\Engine
{
private int $state;
public function __construct(?int $seed = null)
{
if ($seed === null) {
$seed = random_int(0, 0xffff);
}
$this->state = $seed & 0xffff;
}
public function generate(): string
{
$this->state = (61 * $this->state + 17) & 0xffff;
return pack('C', $this->state >> 8);
}
}
$r = new \Random\Randomizer(
new LinearCongruentialGenerator(seed: 1)
);
echo "Número afortunado: ", $r->getInt(0, 99), "\n";
?>El resultado del ejemplo sería:
Número afortunado: 4