array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.random-bytes.php', 1 => 'random_bytes', 2 => 'Obtiene bytes aleatorios criptográficamente seguros', ), 'up' => array ( 0 => 'ref.random.php', 1 => 'Funciones de números aleatorios', ), 'prev' => array ( 0 => 'function.rand.php', 1 => 'rand', ), 'next' => array ( 0 => 'function.random-int.php', 1 => 'random_int', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/random/functions/random-bytes.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

random_bytes

(PHP 7, PHP 8)

random_bytes — Obtiene bytes aleatorios criptográficamente seguros

Descripción

random_bytes(int $length): string

Genera una cadena que contiene bytes seleccionados uniformemente de manera aleatoria con el valor de length.

Dado que los bytes devueltos se eligen completamente al azar, la cadena resultante probablemente contendrá caracteres no imprimibles o secuencias UTF-8 inválidas. Puede ser necesario codificarlos antes de la transmisión o visualización.

La aleatorización generada por esta función es adecuada para todas las aplicaciones, incluyendo la generación de secretos a largo plazo, como claves de cifrado.

Las fuentes de aleatoriedad por orden de prioridad son las siguientes:

Nota: Aunque esta función fue añadida en PHP 7.0, una » implementación en espacio de usuario está disponible para PHP 5.2 hasta 5.6, inclusive.

Parámetros

length

La longitud de la string aleatoria que debe ser devuelta en bytes; debe ser mayor o igual a 1.

Valores devueltos

Devuelve una string que contiene el número solicitado de bytes criptográficamente seguros.

Errores/Excepciones

Historial de cambios

Versión Descripción
8.2.0 En caso de fallo CSPRNG, esta función lanzará ahora una Random\RandomException. Anteriormente se lanzaba una Exception básica.

Ejemplos

Ejemplo #1 Ejemplo con random_bytes()

<?php
$bytes = random_bytes(5);
var_dump(bin2hex($bytes));
?>

Resultado del ejemplo anterior es similar a:

string(10) "385e33f741"

Ver también