PHPのArray_mergeで連想配列を結合！キーが重複した場合の挙動

連想配列を扱う際、複数の配列を結合する方法としてPHPのarray_merge関数はとても便利です。ですがキーの種類（文字列キーか数値キーか）や重複の状況によって結果が変わります。この記事ではPHP Array_merge 連想配列というキーワードに対して、キー重複時の挙動を中心に詳しく解説します。戸惑いやトラブルを避けるための使い分けや代替方法まで含めて学べます。

PHP Array_merge 連想配列における基本的な動作

PHPにおけるarray_merge関数は、一つ以上の配列を結合して新しい配列を返す機能があります。連想配列（文字列キーを持つ配列）を含めた複数の配列を指定すると、文字列キーが重複している場合は後の配列の値で上書きされます。数値キー（インデックス）がある要素については、元のキーを保持せず、結合後は0から順に再番号付けされます。

この動作を前提として理解すると、「文字列キーが重複したときにはどちらの値を使いたいか」「数値キーを保持したいかどうか」で使うべき方法が変わってきます。次節以降で具体例や応用、代替手段を見ていきます。

文字列キーが重複した場合の挙動

異なる配列に同じ文字列キーが含まれているときには、array_mergeは後の配列の方の値で上書きします。例えば「key」が両方にある場合、最後に指定した配列の値が最終結果の「key」の値となります。前の値は破棄されます。

この挙動が求められるケースとしては、設定のデフォルト値とユーザー設定をマージするような場面があります。後者を優先するためにarray_mergeを使うことが一般的です。

数値キーの再番号付けと結合

数値キーを持つ要素（配列のインデックス的な要素）は、array_mergeで結合するとき、元の数値キーを保持せずに「0,1,2,…」と再番号付けされます。異なる配列の要素はすべて保持され、順番通りに並べられますが、数値キーは無視される形となります。

もし数値キーを保持しつつ結合したい場合は、array_mergeではなく他の手段を使う必要があります。後で代替方法を説明します。

ネストされた配列や多次元配列の扱い

array_mergeは配列の中に配列がある場合にも動作しますが、重複する文字列キーの多次元配列同士を結合する場合、後の配列の値でネスト全体が上書きされることがあります。再帰的なマージを望むなら、array_merge_recursiveを検討すべきです。

array_merge_recursiveは同じ文字列キーの値を配列化して保持するため、値が配列の場合でも階層構造を保ちながら結合できます。ただし数値キーに対しては同様に再番号付けされる点に注意が必要です。

キー重複時の挙動を比較する応用ケース

具体的な状況に応じてどの結合方法を選ぶかを理解するために、設定デフォルト＋ユーザー入力、複数ソースのデータ統合、レガシーコードのマージなどでの挙動を比較します。文字列・数値キー、重複、上書き／保持、再帰性など各条件ごとに整理します。

デフォルト設定とユーザー設定のマージ

サイトの設定値などで、デフォルト配列とユーザー入力配列をマージする場合、ユーザー設定の値を優先したいことが多いです。そのため文字列キーが重複したときにはユーザー設定側で上書きされるように、array_mergeの順序を「デフォルト → ユーザー設定」の順で呼び出します。

このとき、数値キーの配列要素はすべて保持されて順番どおりに並ぶとともに、元の数値は失われて再番号付けされます。数値キーの意味が重要であれば、別の方法を選びます。

データソース統合時の重複キーと優先順位

外部APIや複数テーブルからのデータ統合で、同じ文字列キーが複数あり、どれを採用するか（あるいは複数を保持するか）という判断が必要です。array_mergeだと後の方の値が優先されるため、どちらのデータが先に来るかが結果に直結します。

優先順位のルールを明示的に設計し、呼び出し順を管理することが重要です。必要ならarray_merge_recursiveで複数値を配列にする、またはunion演算子やarray_replace系を使用して制御を強化します。

性能と可読性のトレードオフ

配列が大きい場合や重複キーを多用する場合、実行速度やメモリ使用量を考慮しなければなりません。array_mergeやarray_merge_recursiveの呼び出しが深くネストした構造で多用されると、処理コストが上がる可能性があります。

可読性と保守性の観点からも、どの配列がどの順序で渡されるかを明確にし、処理の意図がわかるようにコードを整理しておくことが望ましいです。

代替手段と使い分けのポイント

array_mergeだけではない、重複キーや数値キーをどう扱いたいかによって異なる関数や演算子を使い分けることができます。最新のPHPバージョンでは追加機能や新しい演算子もあり、それらを含めて比較します。

＋演算子（配列の和）を使う方法

PHPにはarray union演算子として「＋」があり、二つの配列を結合する際にキーが重複すると左側（最初の配列）の値を保持し、右側の値を無視します。また数値キーについても再番号付けが行われず、元のキーが保持されます。

数値キーや文字列キー両方を保持したい、そして重複時には先に定義された値を優先したいケースでは、この「＋」演算子が適切な選択肢となります。

array_replace / array_replace_recursive を使うケース

array_replaceは同じキーがあれば後者の配列の値で上書きし、キーがなければ追加しますが、数値キーを文字列キーとは異なり扱い、再番号付けは行われません。ネスト構造を保持したいならarray_replace_recursiveが使えます。

重複キーの扱いを上書き優先とし、ネストの深い配列も対象としたい場合は、この関数群がarray_mergeよりも柔軟です。

array_merge_recursive の特徴と注意点

array_merge_recursiveは文字列キーが重複した場合、値を配列にまとめて保持します。もし両方の値が配列であれば再帰的にマージされます。これにより、重複のあった情報を捨てずにまとめたいときに使えます。

ただしこの方式では配列の構造が変わること、また数値キーは再番号付けされることに注意が必要です。結果の値が配列になるため、値の型が予期しない形に変化する可能性があります。

実践コード例で理解を深める

ここでは具体例を見ながら、どのような結果になるかを確認します。手を動かして試すことで理解が深まります。例は最新のPHP環境を想定しています。

例：文字列キー重複の上書き


$array1 = [ 'key' => 'first', 'a' => 1 ];
$array2 = [ 'key' => 'second', 'b' => 2 ];
$result = array_merge($array1, $array2);
// 結果は ['key' => 'second', 'a' => 1, 'b' => 2]


上記では同じ文字列キー「key」が$‐array2で上書きされます。”first”は捨てられ”second”が残ります。

例：数値キーを持つ配列の結合


$array1 = [ 0 => 'apple', 3 => 'banana' ];
$array2 = [ 1 => 'cherry', 2 => 'date' ];
$result = array_merge($array1, $array2);
// 結果は [ 'apple', 'banana', 'cherry', 'date' ] でキーは 0,1,2,3


元の数値キーは保持されず、値自体はすべて連結されて再番号付けされます。

例：＋演算子との比較


$array1 = [ 'key' => 'first', 0 => 'zero' ];
$array2 = [ 'key' => 'second', 0 => 'newzero' ];
$union = $array1 + $array2;
$merged = array_merge($array1, $array2);
// $union は ['key' => 'first', 0 => 'zero', 1 => 'newzero']
// $merged は ['key' => 'second', 'zero', 'zero', 'newzero'（再番号付け）]


上書きされるキーや再番号付けの有無で結果が大きく異なります。

注意すべき落とし穴とトラブルシューティング

実際にコードを書く際には思わぬ挙動に悩まされることがあります。ここではよくある誤解やバグを未然に防ぐポイントをまとめます。

文字列キーと数値文字列キーの混同

例えばキーが文字列であっても、それが数値文字列（”0″や”1″など）だとPHPが数値キーと見なす場合があります。数値文字列は整数キーとして扱われ、array_mergeで再番号付けされてしまうことがあります。

そのためキーとして文字列を使いたいが数値に近い形なら、プレフィックスを付与するなどして意図的に文字列キーとして扱われるようにする工夫が必要です。

ネストされた配列での予期せぬ上書き

多次元配列で同じ文字列キーを持つ配列をarray_mergeすると、上のレベルで上書きが起きて下のネスト構造が切り捨てられることがあります。情報を失いたくないならarray_merge_recursiveを使い、ネストを再帰的に結合する必要があります。

ただしrecursiveでは配列に変換される場合があるため、値の型チェックや変換の処理を入れると安全です。

パフォーマンス上の注意点

多数の配列を何度もマージしたり、巨大な配列をマージするとメモリ使用量や処理速度の問題が発生することがあります。最新のPHPバージョンではパフォーマンス改善がされているものの、関数の呼び出し順や回数を減らす工夫がコスト削減に役立ちます。

また必要ない深さで再帰的処理を使うとそのコストはさらに上がるので、どこまでネストを考慮するかを設計段階で明確にしておくとよいです。

よくある質問とその答え

読者からよくある疑問について、簡潔に整理したFAQ形式で回答します。ここで疑問が解消できない場合は、先ほどの例や代替手段を再確認してください。

文字列キーが重複するが両方の値を保持したい場合はどうするか

このケースではarray_merge_recursiveを使うと実現できます。重複した文字列キーに対して、それぞれの値が配列の要素となるので両方が保持されます。例として文字列キー「key」に対して異なる値が複数あるとき、それぞれが配列値としてまとめられます。

数値キーをそのまま保持したい場合の手法は？

数値キーを保持するにはarray_mergeではなく＋演算子を使用するのが簡単な方法です。＋演算子は重複キーの扱いが異なり、左側の要素を優先してキーを維持します。他にもforeachループでキーを手動にコピーする方法があります。

混在したキーと再番号付けへの対処方法は？

文字列キーと数値キーが混在する場合、意図しない再番号付けや型変化が起きがちです。なるべく混ぜないか、またはキーがどちらの型として扱われているか明確にしておくことが重要です。文字列として保持したい場合は文字列キーを工夫して定義することが推奨されます。

フロー図による判断チャート

どの方法を使うか迷ったときに使える判断基準をフロー形式で整理します。開発中に参照しやすいように設計の手引きとなる構造です。

以下のチェック項目に沿って選択を進めてください：

• 文字列キーが重複しても後の値で上書きされてよいか？
• 数値キーを再番号付けしても問題ないか？
• 重複値を配列として保持するかどうか？
• ネスト構造を再帰的にマージしたいか？

そしてそれぞれの組み合わせに応じて：

最新のPHPバージョンでの改良点と将来動向

PHPのバージョン進歩により、配列操作に関する機能や挙動は少しずつ改善されています。最新環境ではspread演算子による配列展開や挙動の明確化などが追加されており、キーの扱いに関するドキュメントも更新されています。

spread演算子による配列結合

PHPの新しい書き方として、配列の前に…を付けて複数配列を展開して結合する手法があります。array_mergeと類似の挙動となることが多く、可読性の高いコードを記述できる手段として支持されています。

ドキュメントの明確化と動作保証

文字列キーの優先・数値キーの再番号付けなどの挙動が公式ドキュメントで鮮明にされており、PHPの各バージョンで一貫した振る舞いが保たれるようになっています。これにより、異なる環境での意図しない変化を防げます。

パフォーマンス改善の取り組み

メモリ消費と速度に関して、配列結合のアルゴリズムや内部構造が改善されており、大きな配列のマージ時でも以前ほど大きな遅延が起きにくくなっています。それでも重複キーやネスト構造の操作には注意が必要です。

まとめ

PHPで連想配列を結合する際、array_mergeは最も基本的でよく使われる方法ですが、文字列キー重複時の上書きと数値キーの再番号付けという特徴があります。これを理解しないと意図しないデータ破壊が起きがちです。

重複を配列として保持したいならarray_merge_recursive、数値キーを保持したいなら＋演算子やarray_replace系列の関数を使うのが適切です。最新のPHP環境ではspread演算子も有効な選択肢になります。

用途に応じて適切な関数や書き方を選び、キーの種類や重複の扱いを意識するようにすれば、array_mergeを使っても安心して意図した結果を得られます。