【PHP入門】array_diff_key関数の使い方と動作原理をサンプルコード付きで解説

array_diff_keyは、PHPに標準で組み込まれている関数の一つです。1つ以上の配列のキー同士を比較し、最初の配列にのみ存在するキーとその値の差分を配列として返します。値そのものは比較されず、キーの一致・不一致だけで判定される点が大きな特徴です。

array_diff_key関数の構文

array array_diff_key($array1, $array2, ...)

この関数は、2つ以上の配列を引数として受け取ります。第1引数の配列を基準として、残りのすべての配列とキーを比較し、他の配列には存在しないキーを持つ要素だけを集めた新しい配列を返します。

押さえておきたいポイント

• 比較の対象はキー（文字列キー・数値キーの両方が対象）
• 戻り値は、第1引数の配列から、他の配列に存在しないキーの要素を抜き出したもの
• 連想配列でも通常の添字配列でも利用可能

使用例

<?php
    $my_array1 = array("1"=>"Joe", "45"=>"Goldberg", "37"=>"Charolette", "91"=>"Micheal");
    $my_array2 = array("1"=>"Joe", "45"=>"Goldberg", "37"=>"Charolette");
    $my_array3 = array("1"=>"Joe", "45"=>"Goldberg");
    print_r(array_diff_key($my_array1, $my_array2, $my_array3));
?>

出力結果

Array
(
    [91] => Micheal
)

コードの解説

<?php ?>タグの中で、キーと値のペアを持つ3つの配列を宣言しています。その後、array_diff_key関数を呼び出し、3つの配列すべてを引数として渡しています。内部では以下のような流れで処理が行われます。

1. $my_array1 の各キーが $my_array2 に存在するかどうかを確認する
2. 続いて、$my_array3 にも存在するかどうかを確認する
3. どちらの配列にも存在しなかったキーだけが、結果の配列に残る

この例では、キー「91」を持つ「Micheal」だけが $my_array2 と $my_array3 のどちらにも存在しないため、出力結果には [91] => Micheal のみが表示されます。

類似関数との違いを理解しよう

PHPには配列の差分を求める関数がいくつか用意されており、用途に応じて使い分けることが重要です。

• array_diff()：値を比較して差分を返す
• array_diff_key()：キーを比較して差分を返す
• array_diff_assoc()：キーと値の両方を比較して差分を返す

「キーが一致しているかどうか」だけを見たい場合は array_diff_key を使うのが最適です。データのIDやインデックスをキーとして管理している場面で特に役立ちます。