関数 array_rand

関数 array_rand は、配列からランダムなキーを返します。第一パラメータには配列を指定し、第二のオプションパラメータは、いくつのランダムなキーを返すべきかを指定します。指定されない場合は1つのキーが返され、指定された場合は指定された数のキーが配列の形式で返されます。

構文

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

この例では、関数は配列からランダムなキーを返します:

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

コード実行結果:

'c'

ランダムなキーを元に、配列からランダムな要素を返してみましょう:

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

コード実行結果:

3

第二パラメータに値 3 を指定してみましょう - この場合、関数は 3つのランダムなキー（第二パラメータが3なので3つのキー）の配列を返します:

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

コード実行結果:

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