PHP Manual
Функции CSPRNG
Генерирует криптографически безопасные псевдослучайные байты

random_bytes

(PHP 7)

random_bytes — Генерирует криптографически безопасные псевдослучайные байты

Описание

random_bytes ( int $length ) : string

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

Источник случайных величин используемых данной функцией:

В Windows всегда используется » CryptGenRandom() Начиная с PHP 7.2.0, вместо него всегда будет использоваться » CNG-API.
В Linux, если доступен, используется системный вызов » getrandom(2).
На других платформах используется /dev/urandom.
Если доступные источники случайных величин отсутствуют, то выбрасывается исключение Exception.

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

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

length: Длина генерируемой строки в байтах.

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

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

Ошибки

Если подходящие источники случайных величин отсутствуют, то выбрасывается исключение Exception.
Если задан некорректный параметр, то выбрасывается исключение TypeError.
Если будет задана некорректная длина length, то будет выброшено исключение класса Error.

Примеры

Пример #1 Пример использования random_bytes()


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

Результатом выполнения данного примера будет что-то подобное:

string(10) "385e33f741"

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

random_int() - Генерирует криптографически безопасные псевдослучайные целые числа
openssl_random_pseudo_bytes() - Генерирует псевдослучайную последовательность байт
bin2hex() - Преобразует бинарные данные в шестнадцатеричное представление