array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.random-bytes.php', 1 => 'random_bytes', 2 => 'Генерирует криптографически безопасные случайные байты', ), 'up' => array ( 0 => 'ref.random.php', 1 => 'Функции Random', ), 'prev' => array ( 0 => 'function.rand.php', 1 => 'rand', ), 'next' => array ( 0 => 'function.random-int.php', 1 => 'random_int', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', '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 — Генерирует криптографически безопасные случайные байты

Описание

random_bytes(int $length): string

Функция генерирует строку, которая содержит равномерно выбранные случайные байты. Длину строки определяет параметр length.

Функция выбирает байты случайно, поэтому с большей вероятностью вернёт строку с непечатаемыми символами или недопустимой последовательностью байтов, которую невозможно сопоставить ни с одним символом в кодировке UTF-8. В ряде сценариев перед передачей или выводом двоичную строку потребуется закодировать.

Случайные последовательности, которые генерирует функция, применяют для шифрования и защиты данных: как ключи шифрования, токены доступа, соль для хеширования паролей и другие долгосрочные или временные криптографические параметры.

Источники случайных величин в порядке приоритета:

Замечание: Функцию добавили в PHP 7.0. » Пользовательская реализация функции доступна с PHP 5.2 по PHP 5.6 включительно.

Список параметров

length

Длина генерируемой строки в байтах. При передаче значения меньше 1 функция выдаст ошибку.

Возвращаемые значения

Функция возвращает строку, которая содержит заданное количество криптографически стойких байтов.

Ошибки

Список изменений

Версия Описание
8.2.0 При сбое генератора криптографически безопасных псевдослучайных чисел (англ. Cryptographically Secure Pseudorandom Number Generator, CSPRNG) функция теперь выбрасывает исключение Random\RandomException. Раньше функция выбрасывала исключение Exception.

Примеры

Пример #1 Пример генерации криптографически безопасных случайных байтов функцией random_bytes()

<?php

$bytes = random_bytes(5);
var_dump(bin2hex($bytes));

?>

Вывод приведённого примера будет похож на: 

string(10) "385e33f741"

Смотрите также