Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / PHP

random_bytes()

Gera o número pedido de bytes aleatórios criptograficamente seguros.

Versão: PHP 8.4; repository runtime, production runtime not attested

Sintaxe

random_bytes(int $length): string

Gera o número pedido de bytes aleatórios criptograficamente seguros. Pode produzir bytes nulos e a codificação hexadecimal duplica o comprimento. Um comprimento inferior a um gera ValueError. Em PHP 8.4 uma falha da fonte gera Random\RandomException.

Assinatura

random_bytes(int $length): string

Saída do exemplo

16 32
ValueError

Exemplos

<?php
$bytes=random_bytes(16);
echo strlen($bytes), " ", strlen(bin2hex($bytes)), "\n";
try { random_bytes(0); } catch (ValueError $e) { echo get_class($e); }

Resultado

16 32
ValueError

Fontes