PHPのarray_combine()関数とは？使い方とサンプルコードを解説

PHPのarray_combine()関数は、2つの配列を組み合わせて新しい配列を作成する関数です。1つ目の配列をキーとして、2つ目の配列を値として使用し、両者を結合した配列を返します。

なお、2つの配列の要素数が一致していない場合はFALSEが返される点に注意が必要です。

基本構文

array_combine(keys, values);

パラメータ

• keys − キーとして使用する配列を指定します。

• values − 値として使用する配列を指定します。

戻り値

array_combine()関数は、キーと値を組み合わせた新しい配列を返します。ただし、各配列の要素数が一致しない場合にはFALSEを返します。

それでは、実際に2つの配列を結合する例を見てみましょう。

サンプルコード

<?php
$sports = array('football', 'cricket');
$players = array('david', 'steve');
$res = array_combine($sports, $players);
print_r($res);
?>

実行結果

上記のコードを実行すると、以下のような出力が得られます。

Array
(
    [football] => david
    [cricket] => steve
)

この例では、$sports配列の要素「football」と「cricket」がキーとなり、$players配列の要素「david」と「steve」がそれぞれ対応する値として設定されていることがわかります。

注意点

array_combine()関数を使用する際は、必ず両方の配列の要素数を揃えておきましょう。要素数が異なる場合、PHP 8.0以降ではValueErrorがスローされます（PHP 7以前ではFALSEが返され、警告が発生します）。事前にcount()関数などで要素数を確認しておくと安全です。