Generates cryptographically secure pseudo-random integers

Beschreibung

random_int ( int $min , int $max ) : int

Generates cryptographic random integers that are suitable for use where unbiased results are critical, such as when shuffling a deck of cards for a poker game.

Die Zufallsquellen, die für diese Funktion verwendet werden, sind folgende:

Unter Windows wird immer » CryptGenRandom() verwendet. Seit PHP 7.2.0 wird stattdessen immer » CNG-API verwendet.
Unter Linux wird der Syscall » getrandom(2) verwendet, wenn er verfügbar ist.
Auf anderen Plattformen wird /dev/urandom verwendet.
Ist keine der zuvor aufgezählten Quellen verfübar, wird ein Error geworfen.

Hinweis: Obwohl diese Funktion erst mit PHP 7.0.0 in PHP hinzugefügt wurde, gibt es » Userland-Implementierungen für PHP 5.2 bis einschließlich 5.6.

Parameter-Liste

min: The lowest value to be returned, which must be PHP_INT_MIN or higher.
max: The highest value to be returned, which must be less than or equal to PHP_INT_MAX.

Rückgabewerte

Returns a cryptographically secure random integer in the range min to max, inclusive.

Fehler/Exceptions

Wenn keine angemessene Quelle für Zufallszahlen verfügbar ist, wird eine Exception geworfen.
Werden ungültige Parameter übergeben, so wird ein TypeError geworfen.
If max is less than min, an Error will be thrown.

Beispiele

Beispiel #1 random_int() example


<?php
var_dump(random_int(100, 999));
var_dump(random_int(-1000, 0));
?>

Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:

int(248)
int(-898)

Siehe auch

random_bytes() - Generates cryptographically secure pseudo-random bytes