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