array_rand
Возвращает случайный ключ массива.
Синтаксис
array_rand(array $array, int $num = 1): int|string|arrayПараметры
| Параметр | Тип | Описание |
|---|---|---|
| $array | array | Исходный массив. |
| $num | int | Необязательный. Сколько ключей вернуть. |
Возвращаемое значение
int|string|arrayОдин ключ или массив ключей.
Примеры
Случайный элемент — при каждом запуске свой:
<?php
$colors = ['red', 'green', 'blue'];
echo $colors[array_rand($colors)];Функция возвращает ключ, а не значение:
<?php
$colors = ['red', 'green', 'blue'];
var_dump(is_int(array_rand($colors)));Результат:
bool(true)Примечания
Для розыгрышей и всего, где важна непредсказуемость, берите random_int(): $items[random_int(0, count($items) - 1)].
См. также
- shuffle — Перемешивает элементы массива в случайном порядке.
- random_int — Возвращает случайное целое число из диапазона.
Вопросы и ответы по теме
В учебнике
- Массивы — Списки и ассоциативные массивы в PHP — создание, изменение, перебор и полезные функции.