Fonction array_rand

La fonction array_rand retourne une clé aléatoire d'un tableau. Le premier paramètre spécifie le tableau, et le deuxième paramètre optionnel indique combien de clés aléatoires doivent être retournées. S'il n'est pas spécifié - une seule clé est retournée, et s'il est spécifié - le nombre spécifié de clés sous forme de tableau.

Syntaxe

phparray_rand(array $array, int $num = 1): int|string|array

Exemple

Dans cet exemple, la fonction retournera une clé aléatoire du tableau :

php<?php
  $arr = ['a'=>1, 'b'=>2, 'c'=>3, 'd'=>4, 'e'=>5];
  echo array_rand($arr);
?>

Résultat de l'exécution du code :

php'c'

Exemple

Récupérons un élément aléatoire du tableau, en connaissant la clé aléatoire :

php<?php
  $arr = ['a'=>1, 'b'=>2, 'c'=>3, 'd'=>4, 'e'=>5];
  
  $key = array_rand($arr);
  echo $arr[$key];
?>

Résultat de l'exécution du code :

php3

Exemple

Définissons le deuxième paramètre à la valeur 3 - dans ce cas, la fonction retournera un tableau de 3 clés aléatoires (3 clés - car le deuxième paramètre est égal à 3) :

php<?php
  $arr = ['a'=>1, 'b'=>2, 'c'=>3, 'd'=>4, 'e'=>5];
  
  $keys = array_rand($arr, 3);
  var_dump($keys);
?>

Résultat de l'exécution du code :

php['a', 'b', 'e']

Voir aussi