Documentación offline PHP master

Random\Randomizer::getBytesFromString

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

En esta página

Random\Randomizer::getBytesFromString

Devuelve bytes aleatorios a partir de una cadena

Descripción#

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

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

La probabilidad de que un byte sea seleccionado es proporcional a su parte de la `string` de entrada. Si cada byte ocurre el mismo número de veces, cada byte tiene la misma probabilidad de ser seleccionado.

## Parámetros

`string`  
La `string` de entrada a partir de la cual se seleccionan los bytes devueltos.

`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 tomados de la entrada `string`.

## Errores/Excepciones

- Si `string` está vacía, se lanzará una `ValueError`.

- 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::getBytesFromString
getBytesFromString('abcdefghijklmnopqrstuvwxyz0123456789', 16) ); ?>
Resultado del ejemplo anterior es similar a:

    3zsw04eiubcf82jd.example.com

Generar un código aleatorio para la autenticación multi-factor
getBytesFromString('0123456789', 20), 5)); ?>
Resultado del ejemplo anterior es similar a:

    11551-80418-27047-42075

Seleccionar a partir de una cadena con una distribución no uniforme
getBytesFromString('aaaaabcdef', 20); ?>

```php

Resultado del ejemplo anterior es similar a:

fddacbeaaeaaacaaaaca

Véase también#

Random\Randomizer::getBytes