Documentación offline PHP master

Random\Randomizer::getBytes

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

En esta página

Random\Randomizer::getBytes

Devuelve bytes aleatorios

Descripción#

public Random\Randomizer::getBytes(int $length): string
```php

Genera una cadena que contiene bytes aleatorios seleccionados uniformemente de la `length` solicitada.

Dado que los bytes devueltos se seleccionan de manera completamente aleatoria, la cadena resultante puede contener caracteres no imprimibles o secuencias UTF-8 no válidas. Puede ser necesario codificarla antes de transmitirla o mostrarla.

## Parámetros

`length`  
La longitud de la cadena aleatoria `string` que debe ser devuelta en bytes; debe ser `1` o más.

## Valores devueltos

Una `string` que contiene el número solicitado de bytes aleatorios.

## Errores/Excepciones

- Si el valor de `length` es inferior a `1`, se lanzará una `ValueError`.

- Cualquier `Throwable` lanzado por el método Random\Engine::generate del [`Random\Randomizer::$engine`](#random-randomizer.props.engine) subyacente.

## Ejemplos

Ejemplo de `Random\Randomizer::getBytes`
getBytes(8)), "\n"; ?>

```php

Resultado del ejemplo anterior es similar a:

ebdbe93cd56682c2

Véase también#

random_bytes

bin2hex

base64_encode

Random\Randomizer::getBytesFromString