random_int
(PHP 7, PHP 8)
random_int — Generates cryptographically secure pseudo-random integers
Beschreibung
$min
, int $max
): intGenerates 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
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