random_int

(PHP 7)

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

Описание

int random_int ( int $min , int $max )

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

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

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

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

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

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() - Генератор криптографически безопасных случайных байт