Funkcja PHP array_rand() losowo wybiera i zwraca jeden lub więcej kluczy z tablicy. Funkcja ta nie generuje kryptograficznie bezpiecznych wartości i nie może być używana w zastosowaniach kryptograficznych.
Składnia funkcji PHP array_rand()
Funkcja PHP array_rand() ma następującą składnię:
array_rand(array $array, int $num = 1): int|string|array
Parametry
| Parametr | Opis |
|---|---|
| array | Parametr obowiązkowy. Tablica źródłowa. |
| num | Wartość określająca, ile losowych kluczy ma zostać wybranych. Musi być większa od zera i mniejsza od długości tablicy źródłowej. Wartość domyślna wynosi 1. |
Wartość zwrotna
Jeśli drugi argument funkcji PHP array_rand() ma wartość 1, to funkcja ta zwraca pojedynczą wartość typu odpowiadającego typowi wylosowanego klucza. Jeśli wartość tego argumentu jest większa, funkcja array_rand() zwraca tablicę losowych wartości. W tablicy tej są one ułożone w takiej samej kolejności, w jakiej występowały w tablicy źródłowej.
