array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.openssl-random-pseudo-bytes.php', 1 => 'openssl_random_pseudo_bytes', 2 => 'Gera uma sequência pseudo-aleatória de bytes', ), 'up' => array ( 0 => 'ref.openssl.php', 1 => 'Funções de OpenSSL', ), 'prev' => array ( 0 => 'function.openssl-public-encrypt.php', 1 => 'openssl_public_encrypt', ), 'next' => array ( 0 => 'function.openssl-seal.php', 1 => 'openssl_seal', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/openssl/functions/openssl-random-pseudo-bytes.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

openssl_random_pseudo_bytes

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

openssl_random_pseudo_bytes — Gera uma sequência pseudo-aleatória de bytes

Descrição

openssl_random_pseudo_bytes(int $length, bool &$strong_result = null): string

Gera uma string de bytes pseudo-aleatórios, com o número de bytes determinado pelo parâmetro length.

Também indica se um algoritmo criptograficamente forte foi usado para produzir os bytes pseudo-aleatórios, e faz isso através do parâmetro opcional strong_result. É raro que isso seja false, mas alguns sistemas podem estar quebrados ou antigos.

Parâmetros

length

O comprimento da sequência de bytes desejada. Deve ser um número inteiro positivo menor ou igual a 2147483647. O PHP tentará converter este parâmetro em um número inteiro não nulo para usá-lo.

strong_result

Se passado para a função, conterá um valor bool que determina se o algoritmo usado era "criptograficamente forte", por exemplo, seguro para uso com GPG, senhas, etc. true se sim, caso contrário false.

Valor Retornado

Retorna a string de bytes gerada.

Erros/Exceções

openssl_random_pseudo_bytes() lança uma Exception em caso de falha.

Registro de Alterações

Versão Descrição
8.0.0 strong_result agora pode ser nulo.
7.4.0 A função não retorna mais false em caso de falha, mas em vez disso lança uma Exception.

Exemplos

Exemplo #1 Exemplo de openssl_random_pseudo_bytes()

<?php
for ($i = 1; $i <= 4; $i++) {
$bytes = openssl_random_pseudo_bytes($i, $cstrong);
$hex = bin2hex($bytes);

echo "Comprimentos: Bytes: $i e Hex: " . strlen($hex) . PHP_EOL;
var_dump($hex);
var_dump($cstrong);
echo PHP_EOL;
}
?>

O exemplo acima produzirá algo semelhante a:

Comprimentos: Bytes: 1 e Hex: 2
string(2) "42"
bool(true)

Comprimentos: Bytes: 2 e Hex: 4
string(4) "dc6e"
bool(true)

Comprimentos: Bytes: 3 e Hex: 6
string(6) "288591"
bool(true)

Comprimentos: Bytes: 4 e Hex: 8
string(8) "ab86d144"
bool(true)

Veja Também