(PHP 4, PHP 5, PHP 7, PHP 8)
rand — Генерирует случайное число
Функция rand() возвращает псевдослучайное целое число в диапазоне
от 0 до значения функции getrandmax() ,
если функцию вызвали без параметров min и max.
Вызов rand(5, 15) вернёт случайное число между 5 и 15 включительно.
Функция не создаёт безопасные для криптографических целей значения, поэтому функцию нельзя использовать в криптографических целях или ожидать возврата значения, которое невозможно угадать.
Безопасные для криптографических целей случайные последовательности создаёт композиция класса Random\Randomizer с движком Random\Engine\Secure . В простых сценариях пользуются функциями random_int() и random_bytes() с удобным и безопасным API-интерфейсом, который поддерживается безопасным для криптографических целей CSPRNG-генератором псевдослучайных чисел операционной системы.
Функция создаёт случайные последовательности через глобальный экземпляр генератора псевдослучайных чисел на основе алгоритма Mt19937 «Вихрь Мерсе́на» поэтому разделяет состояние с остальными функциями, которые генерируют случайности через глобальный генератор. Вызов каждой такой функции продвигает последовательность, независимо от области вызова.
Функция выдаст предсказуемые одинаковые последовательности, если инициализировать генератор псевдослучайных чисел функцией mt_srand() или srand() одним и тем же значением.
В новом коде случайные последовательности лучше генерировать через объект Random\Randomizer .
Замечание: До PHP 7.1.0 на отдельных платформах наподобие Windows функция getrandmax() возвращала число не больше 32 767. Число из диапазона больше 32 767 получают путём установки параметров
minиmax, с которыми функция создаёт число из большего диапазона, или вместо этой функции вызывают функцию mt_rand() .
Замечание: Начиная с PHP 7.1.0 функция rand() генерирует случайные числа через тот же алгоритм, что и функция mt_rand() . В целях сохранения обратной совместимости функция rand() разрешает задавать для параметра
maxзначение меньше, чем значение параметраmin, и в отличие от функции mt_rand() не возвращаетfalse.
minНаименьшее возвращаемое значение. Значение по умолчанию равно 0.
maxНаибольшее возвращаемое значение. Значение по умолчанию равно значению, которое возвращает функция getrandmax() .
Функция возвращает псевдослучайное значение в диапазоне от min
или 0 до max или значения функции getrandmax() .
| Версия | Описание |
|---|---|
| 7.2.0 | В функции rand() исправили ошибку смещения по модулю, поэтому последовательности, которые сгенерировали с конкретным начальным значением, не совпадают со значениями, которые сгенерировали в PHP 7.1 на 64-битных машинах. |
| 7.1.0 | Функция rand() стала синонимом функции mt_rand() . |
Пример #1 Пример генерации случайного числа функцией rand()
<?php
echo rand(), "\n";
echo rand(), "\n";
echo rand(5, 15), "\n";Вывод приведённого примера будет похож на:
7771 22264 11
Ширине диапазона min — max нельзя
выходить за границы значения, которое возвращает функция getrandmax() .
Требование выполняется, если: (abs(max - min) <= getrandmax() .
При выходе за пределы диапазона возникает риск снижения качества
случайных чисел, которые возвращает функция rand().