Documentación offline PHP master

gmp_random_bits

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

En esta página

gmp_random_bits

Genera un número aleatorio

Descripción#

gmp_random_bits(int $bits): GMP
```php

Genera un número aleatorio. El número estará en el intervalo `0` y `2$bits - 1`.

El argumento `bits` debe ser mayor que 0, y el valor máximo estará restringido por la memoria disponible.

> [!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

`bits`  
El número de bits a generar.

## Valores devueltos

Un número GMP aleatorio.

## Errores/Excepciones

Si `bits` es menor que `1`, se lanzará una ValueError.

## Ejemplos

Ejemplo con `gmp_random_bits`

```php

El ejemplo anterior mostrará:

3
15