(PHP 4, PHP 5, PHP 7)
array_rand — Escolhe um ou mais elementos aleatórios de um array
Escolhe aleatóriamente um ou mais itens de um array, e retorna a chave (ou chaves) do itens selecionados. Utiliza um gerador de números pseudo randômicos que não é apropriado para uso criptográfico.
arrayO array de entrada.
numEspecifica quantos elementos deseja obter.
Se estiver selecionando apenas um elemento, array_rand() retorna
a chave para este elemento aleatório. De outra forma, ele retorna um array com as chaves desses
elementos selecionados. Assim é possível selecionar os elementos pelas chaves
no array assim como valores aleatórios. Tentar selecionar mais elementos
que a quantidade presente no array resultará em um erro
E_WARNING, e NULL será retornado.
| Versão | Descrição |
|---|---|
| 5.2.10 | O array retornado não é mais embaralhado. |
Exemplo #1 Exemplo de array_rand()
<?php
$input = array("Neo", "Morpheus", "Trinity", "Cypher", "Tank");
$rand_keys = array_rand($input, 2);
echo $input[$rand_keys[0]] . "\n";
echo $input[$rand_keys[1]] . "\n";
?>