【PHP】array_rand()関数の使い方｜配列からランダムなキーを取得する方法

array_rand() 関数は、配列から1つ以上のランダムなキーを取得するためのPHP組み込み関数です。配列の中から要素を無作為に選びたい場合に便利で、くじ引きやシャッフル表示などの実装によく使われます。

基本構文

array_rand(array $array, int $num = 1)

パラメータ

• arr（第1引数）：対象となる配列を指定します。

• count（第2引数）：取得したいランダムキーの数を指定します。省略した場合はデフォルト値の 1 が適用されます。

戻り値

array_rand() 関数は、選択されたランダムなキーを返します。

• 第2引数が 1 の場合（または省略した場合）：単一のキーを返します。

• 第2引数が 2 以上の場合：ランダムなキーを格納した配列を返します。

なお、配列が空の場合はエラー（警告）が発生するため、事前に配列の存在チェックを行うことが推奨されます。

使用例①：キーを1つだけ取得する

次の例では、配列からランダムに1つのキーを取得しています。

<?php
$arr = array("p"=>"mobile","q"=>"laptop","r"=>"tablet");
print_r(array_rand($arr, 1));
?>

出力結果

r

使用例②：複数のキーを取得する

第2引数に 2 を指定すると、重複しない複数のキーが配列として返されます。

<?php
$arr = array("p"=>"mobile","q"=>"laptop","r"=>"tablet");
print_r(array_rand($arr, 2));
?>

出力結果

Array (
    [0] => p
    [1] => q
)

まとめ

array_rand() 関数を使えば、配列から簡単にランダムなキーを抽出できます。ポイントは以下の通りです。

• 第2引数を省略または 1 にすると、単一のキーが返る。

• 第2引数に 2 以上を指定すると、キーの配列が返る。

• 返されるのはキーであり、値ではない点に注意が必要です。値そのものが必要な場合は、取得したキーを使って $arr[$key] のように参照しましょう。