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

random_int

(PHP 7)

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

Описание

random_int ( int $min , int $max ) : int

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

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

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

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

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

min: Нижняя граница диапазона, из которого будет выбрано случайное число. Должна быть больше или равна PHP_INT_MIN.
max: Верхняя граница диапазона, из которого будет выбрано случайное число. Должна быть меньше или равна PHP_INT_MAX.

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

Генерирует криптографически безопасное случайное целое число в диапазоне от min до max, включительно.

Ошибки

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

Примеры

Пример #1 Пример random_int()


<?php
var_dump(random_int(100, 999));
var_dump(random_int(-1000, 0));
?>

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

int(248)
int(-898)

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

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