random_int

(PHP 7)

random_intGé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 entiers pseudo-aléatoire cryptographiquement sécurisé dans l'intervale inclusive entre min et max.

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(100999));
var_dump(random_int(-10000));
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

int(248)
int(-898)

Voir aussi

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