Documentación offline PHP master

gmp_random_range

master Ver versión oficial en línea Licencia CC-BY-3.0Descargado el 2026-08-02

En esta página

gmp_random_range

Obtener un entero seleccionado uniformemente

Descripción#

gmp_random_range(GMP $min, GMP $max): GMP
```php

Genera un número aleatorio. El número estará en el intervalo `min` y `max`.

`min` y `max` pueden ser ambos negativos, pero `min` debe ser siempre inferior a `max`.

> [!CAUTION]
> Esta función no genera valores criptográficamente seguros, y *no debe* ser utilizada con fines criptográficos, o con fines que requieran que los valores devueltos sean indescifrables.
>
> Si se requiere aleatoriedad criptográficamente segura, el `Random\Randomizer` puede ser utilizado con el motor `Random\Engine\Secure`. Para casos de uso simples, las funciones `random_int` y `random_bytes` proporcionan una API práctica y segura que es soportada por el CSPRNG del sistema operativo.

## Parámetros

`min`  
Un número GMP que representa el límite inferior para el número aleatorio.

`max`  
Un número GMP que representa el límite superior para el número aleatorio.

## Valores devueltos

Devuelve un objeto `GMP` que contiene un entero seleccionado uniformemente en el intervalo cerrado \[`min`, `max`\]. `min` y `max` son ambos valores de retorno posibles.

## Errores/Excepciones

Si `max` es inferior a `min`, se lanzará una ValueError.

## Ejemplos

Ejemplo con `gmp_random_range`

```php

El ejemplo anterior mostrará:

42
-67