php man page for gmp_random_bits

GMP_RANDOM_BITS(3)							 1							GMP_RANDOM_BITS(3)

gmp_random_bits - Random number

SYNOPSIS
       GMP gmp_random_bits (integer  $bits)

DESCRIPTION
	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.

PARAMETERS
	      o $bits
		-  The number of bits. Either a GMP number resource in PHP 5.5 and earlier, a GMP object in PHP 5.6 and later, or a numeric string
		provided that it is possible to convert the latter to a number.

RETURN VALUES
	A random GMP number.

EXAMPLES
       Example #1

	      gmp_random_bits(3) 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) . "
";
	      echo gmp_strval($rand2) . "
";
	      ?>

	      The above example will output:

	      3
	      15

PHP Documentation Group 													GMP_RANDOM_BITS(3)