Génère des nombres entiers pseudo-aléatoire cryptographiquement sécurisé

Description

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

Génère un entier aléatoires cryptographiques qui convient à un usage où des résultats impartial sont critique, comme lors d'un mélange d'un paquet de cartes pour une partie de poker.

La source des données aléatoires utilisée pour cette fonction est :

Sous Windows, » CryptGenRandom() sera toujours utilisé. À partir de PHP 7.2.0 c'est » CNG-API qui sera toujours utilisé à la place
Sous Linux, l'appel système » getrandom(2) sera utilisé si disponible.
Sous les autres plate-formes, /dev/urandom sera utilisé.
Si tout ce qui précède n'est pas disponible, alors une Exception sera émise.

Note: Bien que cette fonction ait été ajoutée en PHP 7.0, une » implementation en espace utilisateur est disponible pour PHP 5.2 jusqu'à 5.6, inclus.

Liste de paramètres

min: La valeur minimale à retourner, qui doit être PHP_INT_MIN ou supérieur.
max: La valeur maximale à retourner, qui doit être moins ou égal à PHP_INT_MAX.

Valeurs de retour

Retourne un nombre entier pseudo-aléatoire cryptographiquement sécurisé dans l'intervale entre min et max inclus.

Erreurs / Exceptions

Si aucune source de données aléatoires n'est trouvée, une Exception sera émise.
Si un paramètre invalide est fourni, une exception de type TypeError sera émise.
Si max est moins que min, une Error sera lancée.

Exemples

Exemple #1 Exemple avec random_int()


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

Résultat de l'exemple ci-dessus est similaire à :

int(248)
int(-898)

Voir aussi

random_bytes() - Génère des octets pseudo-aléatoire cryptographiquement sécurisé