random_int

(PHP 7)

random_intGenera números enteros seudoaleatorios criptográficamente seguros

Descripción

random_int ( int $min , int $max ) : int

Genera números enteros aleatorios criptográficos aptos para resultados imparciales críticos, tales como barajar una baraja de cartas de póquer.

Las fuentes de aleatoriedad empleadas por esta función son las siguientes:

  • En Windows, se utilizará siempre » CryptGenRandom(). A partir de PHP 7.2.0, se usará siempre » CNG-API.
  • En Linux, se utilizará la llamada al sistema » getrandom(2) si está disponible.
  • En otras plataformas, se utilizará /dev/urandom.
  • Si no están disponibles ninguna de las fuentes citadas anteriormente, se lanzará una Exception.

Nota: Aunque esta función se añadió a PHP en PHP 7.0, hay disponible una » implementación de espacio de usuario para PHP 5.2 hasta 5.6, inclusive.

Parámetros

min

El valor mínimo a devolver, el cual debe ser PHP_INT_MIN o mayor.

max

El valor máximo a devolver, el cual debe ser menor o igual que PHP_INT_MAX.

Valores devueltos

Devuelve un número entero aleatorio criptográficamente seguro en el rango min a max, inclusive.

Errores/Excepciones

  • Si no se puede encontrar una fuente de aleatoriedad apropiada, se lanzará una Exception.
  • Si se proporcionan parámetros inválidos, se lanzará un TypeError.
  • Si max es menor que min, se lanzará un Error.

Ejemplos

Ejemplo #1 Ejmplo de random_int()

<?php
var_dump
(random_int(100999));
var_dump(random_int(-10000));
?>

El resultado del ejemplo sería algo similar a:

int(248)
int(-898)

Ver también

  • random_bytes() - Genera bytes seudoaleatorios criptográficamente seguros