random_int

(PHP 7, PHP 8)

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

Описание

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

Функция создаёт равномерно выбранное целое число между заданными минимумом и максимумом.

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

Источники случайных величин в порядке приоритета:

  • Linux: » getrandom(), /dev/urandom
  • FreeBSD >= 12 (PHP >= 7.3): » getrandom(), /dev/urandom
  • Windows (PHP >= 7.2): » CNG-API Windows: » CryptGenRandom
  • macOS (PHP >= 8.2; >= 8.1.9; >= 8.0.22, если CCRandomGenerateBytes доступен во время компиляции): CCRandomGenerateBytes() macOS (PHP >= 8.1; >= 8.0.2): arc4random_buf(), /dev/urandom
  • NetBSD >= 7 (PHP >= 7.1; >= 7.0.1): arc4random_buf(), /dev/urandom
  • OpenBSD >= 5.5 (PHP >= 7.1; >= 7.0.1): arc4random_buf(), /dev/urandom
  • DragonflyBSD (PHP >= 8.1): » getrandom(), /dev/urandom
  • Solaris (PHP >= 8.1): » getrandom(), /dev/urandom
  • Остальные комбинации операционной системы и версии PHP: /dev/urandom
  • Функция выбросит исключение Random\RandomException, если все источники оказались недоступны или в каждом возникла ошибка генерации случайной последовательности.

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

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

min

Нижняя граница диапазона.

max

Верхняя граница диапазона.

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

Функция возвращает криптографически безопасное равномерно выбранное целое число из замкнутого интервала [min, max]. Функция возвращает как значение min так и значение max.

Ошибки

  • При недоступности источников случайных величин выбрасывается исключение Random\RandomException.
  • Функция выбросит исключение ValueError, если задать значение max меньше, чем значение min.

Список изменений

Версия Описание
8.2.0 Теперь при сбое генератора CSPRNG функция будет выбрасывать исключение Random\RandomException. Раньше функция выбрасывала исключение Exception.

Примеры

Пример #1 Пример использования функции random_int()

<?php

var_dump(random_int(100, 999));
var_dump(random_int(-1000, 0));

?>

Вывод приведённого примера будет похож на: 

int(248)
int(-898)

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

  • Random\Randomizer::getInt() - Получает равномерно выбранное целое число
  • random_bytes() - Генерирует криптографически безопасные случайные байты