getrandmax()

The PHP getrandmax() function returns the largest integer that the rand() function can produce when called with no arguments. Knowing this upper bound lets you safely scale random values into your own range, which is why getrandmax() is most useful alongside rand() rather than on its own.

Syntax

getrandmax(): int

getrandmax() takes no parameters and returns an int. On modern PHP (7.1 and later) it consistently returns 2147483647 (the maximum value of a signed 32-bit integer, 2^31 - 1) regardless of the operating system or architecture. Before PHP 7.1 the value could differ between platforms, which is one reason the more portable mt_rand() family is now preferred.

How to use getrandmax()

Because it takes no arguments, calling the function is straightforward:

This prints 2147483647 on a modern PHP installation.

Scaling rand() into a custom range

The main practical use of getrandmax() is converting rand()'s output into a fraction or a smaller range. Dividing rand() by getrandmax() produces a float between 0 and 1, which you can then multiply to fit any range you need:

<?php
// A random float between 0 and 1
$fraction = rand() / getrandmax();

// Scale that fraction into the range 0–100
$scaled = $fraction * 100;

echo "Fraction: " . ($fraction >= 0 && $fraction <= 1 ? "in [0, 1]" : "out of range") . "\n";
echo "Scaled value is between 0 and 100: " . ($scaled >= 0 && $scaled <= 100 ? "yes" : "no") . "\n";
?>

Here the output confirms the fraction stays within [0, 1] and the scaled value within [0, 100]. Because the exact numbers are random, checking the range (rather than a fixed value) is the reliable way to verify the logic.

getrandmax() vs. mt_getrandmax()

In PHP 7.0+, rand() and mt_rand() share the same underlying random number generator, so getrandmax() and mt_getrandmax() return the same value. For new code, prefer:

• mt_rand() for faster, better-quality pseudo-random numbers.
• random_int() when you need cryptographically secure values (passwords, tokens, security codes).

Reach for rand() and getrandmax() mainly when working with legacy code that already uses them.

Conclusion

The getrandmax() function reports the upper limit of rand(), a fixed 2147483647 on modern PHP. Its real value is as the denominator when scaling random integers into floats or custom ranges. For new projects, prefer the mt_rand() family or random_int() for security-sensitive randomness.

Practice