gmp_random_bits

(PHP 5 >= 5.6.3, PHP 7, PHP 8)

gmp_random_bits — Генерирует случайное число

Описание

gmp_random_bits(int $bits): GMP

Генерирует случайное число. Число будет находиться в диапазоне между 0 и 2^$bits - 1.

Значение параметра bits должно быть больше 0, а максимальное значение ограничено размером доступной памяти.

Предостережение

Функция не создаёт безопасные для криптографических целей значения, поэтому функцию нельзя использовать в криптографических целях или ожидать возврата значения, которое невозможно угадать.

Безопасные для криптографических целей случайные последовательности создаёт композиция класса Random\Randomizer с движком Random\Engine\Secure. В простых сценариях пользуются функциями random_int() и random_bytes() с удобным и безопасным API-интерфейсом, который поддерживается безопасным для криптографических целей CSPRNG-генератором псевдослучайных чисел операционной системы.

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

bits: Количество битов для генерации.

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

Случайное GMP-число.

Ошибки

Если значение параметра bits будет меньше 1, будет выброшено исключение ValueError.

Примеры

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

<?php

$rand1 = gmp_random_bits(3); // случайное число от 0 до 7
$rand2 = gmp_random_bits(5); // случайное число от 0 до 31

echo gmp_strval($rand1) . "\n";
echo gmp_strval($rand2) . "\n";
?>

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

3
15