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(100999));
var_dump(random_int(-10000));
?>

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

int(248)
int(-898)

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

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