【PHP8.x】array_diff()関数の使い方

Copy
1<?php
2
3/**
4 * array_diff_assoc() は、最初の配列に存在するが、
5 * 他の配列にはキーと値の両方が完全に一致する要素が存在しないエントリを返します。
6 * これは、キーも値も両方が一致しないと「差分」と見なされることを意味します。
7 * キーの型も比較対象となります。
8 */
9
10// 最初の配列を定義します。
11// 各要素はキーと値のペアを持ちます。
12$array1 = [
13    "fruit_a" => "apple",
14    "fruit_b" => "banana",
15    "fruit_c" => "cherry",
16    "color_a" => "red",
17    0          => "grape", // 数値キーの例
18    "1"        => "lemon", // 文字列キーの例
19];
20
21// 比較対象の2番目の配列を定義します。
22// array1との違いに注目してください。
23$array2 = [
24    "fruit_a" => "apple",    // キーと値がarray1と一致するため、差分ではない
25    "fruit_b" => "grape",    // キーは同じだが値が異なるため、差分である
26    "fruit_d" => "date",     // array1には存在しないキーなので、差分ではない
27    "color_a" => "blue",     // キーは同じだが値が異なるため、差分である
28    0          => "grape",    // キーと値がarray1と一致するため、差分ではない
29    1          => "lemon",    // キーの型がarray1と異なるため、差分である (array1は文字列"1"、array2は数値1)
30];
31
32// array_diff_assoc() を使用して、
33// array1に存在するが、array2にはキーと値が完全に一致する要素がないエントリを見つけます。
34$diffResult = array_diff_assoc($array1, $array2);
35
36echo "array_diff_assoc の結果:\n";
37print_r($diffResult);
38
39/*
40実行結果の解説:
41Array
42(
43    [fruit_b] => banana
44    [fruit_c] => cherry
45    [color_a] => red
46    [1] => lemon
47)
48
49- "fruit_a" => "apple": array1とarray2で完全に一致するため、結果には含まれません。
50- "fruit_b" => "banana": array1では"banana"ですが、array2ではキー"fruit_b"の値が"grape"です。
51  値が異なるため、array1のこの要素はarray2に存在しないと判断され、結果に含まれます。
52- "fruit_c" => "cherry": array1には存在しますが、array2にはキー"fruit_c"が存在しないため、結果に含まれます。
53- "color_a" => "red": array1では"red"ですが、array2ではキー"color_a"の値が"blue"です。
54  値が異なるため、array1のこの要素はarray2に存在しないと判断され、結果に含まれます。
55- 0 => "grape": array1とarray2で完全に一致するため、結果には含まれません。
56- "1" => "lemon": array1ではキーが文字列"1"ですが、array2ではキーが数値1です。
57  キーの型が異なるため、array1のこの要素はarray2に存在しないと判断され、結果に含まれます。
58*/
59

PHPのarray_diff_assoc関数は、複数の配列を比較し、最初の配列に存在する要素のうち、比較対象となる他のどの配列にもキーと値の両方が完全に一致する要素がないものを抽出して新しい配列として返します。この関数は、引数として最初の配列（基準となる配列）と、比較したい1つ以上の配列を受け取ります。戻り値は、差分と判断された要素のみを含む新しい配列です。

この関数では、要素が「差分」とみなされる条件は、キーと値のペアが完全に一致しない場合です。特に重要なのは、キーの値だけでなく、キーのデータ型も厳密に比較の対象となる点です。例えば、文字列のキー"1"と数値のキー1は異なるものとして扱われます。

サンプルコードでは、$array1と$array2を比較しています。$array1の"fruit_b" => "banana"は、$array2に同じキー"fruit_b"が存在しますが値が"grape"と異なるため、差分として抽出されます。また、$array1の"fruit_c" => "cherry"は、$array2にキー自体が存在しないため、差分となります。さらに、$array1の"1" => "lemon"は、$array2には数値キーの1 => "lemon"として存在しますが、キーの型が異なるため、$array1の要素が差分として結果に含まれます。このように、array_diff_assocは厳密な比較を行うため、期待する結果を得るためにはキーと値、そしてキーの型の両方に注意が必要です。

Copy
1<?php
2
3// 比較対象となる最初の配列を定義します。
4$array1 = ["apple", "banana", "orange", "grape"];
5
6// 比較する2つ目の配列を定義します。
7$array2 = ["banana", "orange", "kiwi", "grape"];
8
9// array_diff() 関数は、$array1 に存在し、$array2 には存在しない値の差分を返します。
10// この関数は配列の値を比較し、キーは比較しません。
11$difference = array_diff($array1, $array2);
12
13// 結果の配列を表示します。
14// この例では、$array1 から "banana", "orange", "grape" が除外され、"apple" のみが残ります。
15print_r($difference);
16
17?>

array_diff関数は、複数の配列を比較し、最初の配列に存在し、かつ比較対象となる他の配列には存在しない値の差分を見つけ出すために使用されます。この関数は、特定の配列から重複する要素を除外したい場合に役立ちます。

引数には、まず基準となる最初の配列を指定し、その後に比較したい他の配列を1つ以上指定します。array_diffはこれらの配列の「値」のみを比較し、配列の「キー」は比較しません。戻り値は、最初の配列にだけ含まれる要素で構成された新しい配列です。

サンプルコードでは、$array1が比較の基準となる配列で、"apple", "banana", "orange", "grape"を含みます。$array2は比較対象の配列で、"banana", "orange", "kiwi", "grape"を含んでいます。

array_diff($array1, $array2)を実行すると、$array1の要素のうち、$array2に存在しないものだけが抽出されます。"banana", "orange", "grape"は両方の配列に共通して存在するため、結果からは除外されます。最終的に$array1にのみ存在する"apple"が差分として残り、$difference変数に["apple"]という配列が格納されます。この内容がprint_r関数によって画面に表示されます。

Copy
1<?php
2
3/**
4 * array_diff_key関数の使用例を示します。
5 * この関数は、最初の配列とそれ以降の配列のキーを比較し、
6 * 最初の配列にのみ存在するキーとその値からなる配列を返します。
7 *
8 * @return void
9 */
10function demonstrateArrayDiffKey(): void
11{
12    // 例1: 2つの配列のキーを比較
13    echo "--- 例1: 2つの配列のキーを比較 ---" . PHP_EOL;
14
15    // 最初の配列を定義します
16    $array1 = [
17        'apple'  => 1,
18        'banana' => 2,
19        'cherry' => 3,
20        'date'   => 4,
21    ];
22    echo "最初の配列 (\$array1):" . PHP_EOL;
23    print_r($array1);
24
25    // 比較対象の配列を定義します
26    $array2 = [
27        'banana' => 20, // キー 'banana' は array1 にも存在する
28        'date'   => 40,   // キー 'date' は array1 にも存在する
29        'elder'  => 50,   // キー 'elder' は array1 に存在しない
30    ];
31    echo "比較対象の配列 (\$array2):" . PHP_EOL;
32    print_r($array2);
33
34    // array_diff_keyを使用して、array1にのみ存在するキーの要素を抽出します。
35    // 'apple' と 'cherry' のキーは array2 に存在しないため、これらの要素が結果に含まれます。
36    $result1 = array_diff_key($array1, $array2);
37    echo "array_diff_keyの結果 (最初の配列にのみ存在するキーの要素):" . PHP_EOL;
38    print_r($result1);
39    echo PHP_EOL;
40
41    // 例2: 複数の配列のキーを比較
42    echo "--- 例2: 複数の配列のキーを比較 ---" . PHP_EOL;
43
44    // 最初の配列
45    $arrayA = [
46        'color'    => 'red',
47        'size'     => 'M',
48        'material' => 'cotton',
49        'brand'    => 'XYZ',
50    ];
51    echo "最初の配列 (\$arrayA):" . PHP_EOL;
52    print_r($arrayA);
53
54    // 比較対象の配列1
55    $arrayB = [
56        'size'     => 'L',
57        'material' => 'silk',
58        'pattern'  => 'striped',
59    ];
60    echo "比較対象の配列1 (\$arrayB):" . PHP_EOL;
61    print_r($arrayB);
62
63    // 比較対象の配列2
64    $arrayC = [
65        'color' => 'blue',
66        'price' => 100,
67    ];
68    echo "比較対象の配列2 (\$arrayC):" . PHP_EOL;
69    print_r($arrayC);
70
71    // array_diff_keyは、arrayAのキーのうち、arrayBにもarrayCにも存在しないキーを持つ要素を返します。
72    // - 'color' は arrayC に存在する
73    // - 'size' は arrayB に存在する
74    // - 'material' は arrayB に存在する
75    // - 'brand' は arrayB と arrayC のどちらにも存在しない
76    // よって、結果は 'brand' の要素のみとなります。
77    $result2 = array_diff_key($arrayA, $arrayB, $arrayC);
78    echo "array_diff_keyの結果 (最初の配列にのみ存在するキーの要素):" . PHP_EOL;
79    print_r($result2);
80    echo PHP_EOL;
81}
82
83// demonstrateArrayDiffKey関数の使用例を実行します
84demonstrateArrayDiffKey();
85
86?>

PHP 8で利用できるarray_diff_key関数は、複数の配列のキーを比較し、最初の配列にのみ存在するキーを持つ要素を抽出する際に使用します。この関数は、最初の引数に指定された配列を基準とし、その後に続く引数で渡された一つ以上の配列と比較を行います。戻り値として、最初の配列のキーのうち、比較対象となる他のどの配列にも存在しないキーとその値からなる新しい配列を返します。

引数$arrayは比較の基準となる最初の配列であり、...$arraysは最初の配列と比較したい一つ以上の配列です。この関数は、要素の値自体ではなく、キーの存在のみを比較の対象とします。

例えば、サンプルコードの例1では、$array1と$array2のキーを比較しています。array_diff_key($array1, $array2)を実行すると、$array1に存在するキーのうち、$array2には存在しないキーである'apple'と'cherry'を持つ要素が結果として得られます。

また、この関数は複数の配列を同時に比較することも可能です。例2のようにarray_diff_key($arrayA, $arrayB, $arrayC)と指定した場合、$arrayAのキーのうち、$arrayBと$arrayCのどちらにも存在しないキーを持つ要素のみが抽出されます。これにより、ある配列にだけ存在するユニークなキーを持つ要素を簡単に特定できます。

Copy
1<?php
2
3// array_diff は、最初の配列に存在するが、後続のどの配列にも存在しないすべての値を比較し、その差を返します。
4// 連想配列の場合でも、キーではなく値のみが比較の対象となります。
5
6// 比較対象となる最初の連想配列を定義
7$firstArray = [
8    'user_a_id' => 'Alice',
9    'user_b_id' => 'Bob',
10    'user_c_id' => 'Charlie',
11    'user_d_id' => 'David',
12];
13
14// 比較される2番目の連想配列を定義
15// 'Bob' と 'David' は $firstArray にも存在する値なので、これらは差分には含まれません。
16$secondArray = [
17    'temp_101' => 'Bob',
18    'temp_102' => 'Eve',
19    'temp_103' => 'David',
20];
21
22// 最初の配列に存在するが、2番目の配列には存在しない値を抽出します。
23// 結果として 'Alice' と 'Charlie' が抽出されます。
24$difference = array_diff($firstArray, $secondArray);
25
26echo "--- 最初の連想配列 ---" . PHP_EOL;
27print_r($firstArray);
28
29echo PHP_EOL . "--- 2番目の連想配列 ---" . PHP_EOL;
30print_r($secondArray);
31
32echo PHP_EOL . "--- array_diff の結果 (最初の配列にのみ存在する値) ---" . PHP_EOL;
33print_r($difference);
34
35// 複数の配列と比較する例
36$thirdArray = [
37    'admin_id_a' => 'Alice', // 'Alice' は $firstArray にも存在
38    'admin_id_b' => 'Frank',
39];
40
41// $firstArray に存在し、$secondArray と $thirdArray のどちらにも存在しない値を抽出します。
42// $firstArray: ['Alice', 'Bob', 'Charlie', 'David']
43// $secondArray: ['Bob', 'Eve', 'David']
44// $thirdArray: ['Alice', 'Frank']
45// 'Alice', 'Bob', 'David' は他の配列にも存在するため、結果から除外されます。
46// 結果として 'Charlie' のみが残ります。
47$multipleDifferences = array_diff($firstArray, $secondArray, $thirdArray);
48
49echo PHP_EOL . "--- 3番目の連想配列 ---" . PHP_EOL;
50print_r($thirdArray);
51
52echo PHP_EOL . "--- array_diff の結果 (複数の配列と比較) ---" . PHP_EOL;
53echo "(最初の配列に存在し、2番目と3番目のどちらにも存在しない値)" . PHP_EOL;
54print_r($multipleDifferences);
55
56?>

PHPのarray_diff関数は、複数の配列を比較し、最初の配列に存在するが、後続のどの配列にも存在しない値だけを抽出した新しい配列を返します。この関数の引数には、まず比較の基準となる最初の配列を指定し、その後ろに1つ以上の比較対象となる配列を続けます。戻り値は、最初の配列にのみ存在する値で構成される配列です。

array_diffは、配列のキーではなく「値」のみを比較します。したがって、連想配列を比較する際もキーは無視され、値が一致すれば差分とはなりません。サンプルコードでは、$firstArrayと$secondArrayを比較しており、$firstArrayにのみ存在する「Alice」と「Charlie」が差分として抽出されます。これは、両者が$secondArrayには含まれていないためです。

また、この関数は複数の配列と同時に比較することも可能です。$firstArrayを基準に$secondArrayと$thirdArrayの両配列と比較した場合、$firstArrayに存在し、かつ他の両配列のどちらにも含まれない値が抽出されます。この例では、「Charlie」のみが最終的な差分として残ります。このように、特定の配列から他の複数の配列に含まれる要素を除外する際に役立ちます。