gmp_random_bits

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

gmp_random_bits — Random number

Опис

gmp_random_bits(int $bits): GMP

Generate a random number. The number will be between 0 and 2^$bits - 1.

bits must greater than 0, and the maximum value is restricted by available memory.

Застереження

Ця функція не генерує криптографічно безпечні значення, тож не повинна використовуватись для криптографічних цілей чи тих, що вимагають використання непередбачуваних значень.

Якщо потрібна криптографічно безпечна випадковість, можна використати Random\Randomizer разом з рушієм Random\Engine\Secure. Для простих випадків є функції random_int() і random_bytes(), які забезпечують зручний і безпечний API до системного CSPRNG.

Параметри

bits: The number of bits to generate.

Значення, що повертаються

A random GMP number.

Помилки/виключення

If bits is less than 1, a ValueError will be thrown.

Приклади

Приклад #1 gmp_random_bits() example

<?php
$rand1 = gmp_random_bits(3); // random number from 0 to 7
$rand2 = gmp_random_bits(5); // random number from 0 to 31

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

Поданий вище приклад виведе:

3
15