連想配列同士をマージするとき、キーが重複したらどうなるか気になりますよね。PHPのarray_merge関数は便利ですが、扱いを誤ると意図しない上書きやインデックスの再番号付けが起きてしまいます。この記事ではPHP Array_merge 連想配列を中心に、重複キーの挙動、代替手段、ネスト配列の場合の対応などを丁寧に解説します。最新情報に基づいて理解を深めて、実際のコードで使えるテクニックを身につけて下さい。
PHP Array_merge 連想配列の基本的な挙動と定義
PHPのarray_merge関数は、複数の配列を結合して一つの配列を返します。連想配列（キーが文字列や数字である配列）の場合、文字列キーが重複したときには後に指定された配列の値が先の値を上書きします。数値キーが使われている場合、これらは「インデックス型」として扱われ、後の配列の要素は数値キーに関係なく末尾に追加され、結果の配列では再番号付けされて０から始まる連番に変更されます。
また、array_merge関数はネストされた配列を深くマージするわけではなく、重複するキーを持つサブ配列があると、後の配列のサブ配列が前を完全に置き換えてしまいます。これは意図しないデータ消失を招くことがありますので注意が必要です。
文字列キーの重複時の上書き
連想配列で文字列キーが重複すると、最後に指定した配列の値が優先されます。このとき、前の配列にあった同じキーの要素は結果から消え、後の配列の値だけが残ります。これは設定の優先順位を制御したいときには便利です。
例えば設定ファイルの初期値を連想配列で定義し、ユーザーの設定を上書きするような場面で、array_mergeを使うと短く簡潔に書くことができます。
数値キーの再番号付けと挙動
数値キーが指定されている要素は、array_mergeで結合されるときに無条件で再番号付けされ、結果の配列では０から始まる連番となります。つまり、元のキーの順番や値は維持されますが、キー自体は新しくなります。
この特性は、数値キーが意味を持つケース（例：IDやタイムスタンプ）で使用すると誤動作の原因になります。そのようなときは他の手段を検討する必要があります。
ネスト配列に対する浅いマージの問題
array_mergeは浅いマージであり、ネストされた配列構造がある場合、重複する文字列キーを持つサブ配列は後のものが前を完全に置き換えます。個々のネストされたキーの内容を保持・統合したいときには向きません。
そのようなケースにはarray_merge_recursiveを使ったり、カスタム関数で再帰的にマージする方法が一般的です。ネスト構造を壊さずに統合するには、用途により使い分けが必要です。
重複キーを避けるための代替手段とテクニック
string型キーの重複を避けたい場合や、数値キーをそのまま使いたい場面では、array_mergeだけでは不十分です。ここでは代替手段と具体的テクニックを紹介します。目的に応じて最適な方法を選んで下さい。
プラス演算子（+）を使う方法
PHPにはarray1 + array2という「配列の和」演算子があります。これは重複するキーがあったとき、左側の配列の要素を優先し、右側の配列の重複要素を無視します。数値キーもそのまま保持され、再番号付けされませんので、キーを維持したい場合に有用です。
ただしこの演算子は、文字列キーの重複を「上書きせずに放置する」という挙動になります。用途によっては期待と異なる結果を生むことがありますので、併用時には明示的に確認することが望まれます。
array_replace関数を使う方法
array_replaceは、重複するキーを持つ配列同士を結合するときに、後の配列の値で前の値を置き換えるという挙動です。これにより文字列キーの重複時に明確に「置き換える」ことができますが、数値キーもキーのまま扱われる点でarray_mergeとは異なります。
この関数は特に設定ファイルのマージや、ユーザー値をデフォルト値に適用する際など、先の値を壊さずに後の値を上書きする用途で重宝します。
foreachやカスタム関数を使って手動マージする方法
もっと細かくキーの重複を制御したい場合、foreachループで要素を順に検査しながらマージする方法があります。この方法だと、重複時に結合する、値を配列にまとめる、あるいは特定条件でのみ上書きする、といった柔軟な処理が可能です。
こうしたコードは少し冗長になりますが、期待する結果と挙動を明示的に制御できるのでバグ防止に役立ちます。複雑なデータ構造を扱うときには特におすすめです。
PHPのバージョンや最新仕様における注意点
PHPのバージョンによってarray_mergeやその他の配列操作関数の挙動・例外処理が改善されています。最新情報に基づいて、現行バージョンでの特徴や変更点を押さえておくことが重要です。
引数なしでの呼び出しと型の扱い
現行バージョンでは、array_mergeを引数なしで呼び出すと空配列を返すようになっています。以前は少なくとも一つ配列を渡す必要がありました。これにより引数生成を動的にするコードでも安全に呼べるようになりました。
また、配列以外の型を渡すと例外や型エラーになるケースがあります。特に型宣言を使っているプロジェクトでは、引数の型を確認してから呼び出すことが望ましいです。
スプレッド演算子（…）との関係
現在では配列の展開を行うスプレッド演算子を使って複数の配列を結合する構文が利用できます。これはarray_mergeと同じような動作をしますが、可読性やパフォーマンスの観点で有利な場合があります。ただしスプレッド演算子では重複キーの挙動はarray_mergeと同じですので、過信は禁物です。
数値キーの再番号付けや上書きの動きは変わりませんから、挙動を理解した上でどちらを使うか判断して下さい。
関数間のパフォーマンス比較
大規模な配列を扱うとき、array_merge、array_replace、手動マージなどの方法によって処理時間に差が出ます。最新のベンチマークによれば、単純なマージであればarray_mergeやスプレッド演算子の方が高速であることが多く、foreachなどはやや遅くなります。
しかし可読性や制御性、安全性を優先する場合は、多少のパフォーマンス低下を許容して手動制御を行うのが望ましいこともあります。
実践例：重複キーを避けて連想配列をマージするコードサンプル
理論だけでなく、実際のコードで重複キーをどう扱うかを見ておきましょう。設定データやユーザー入力、APIレスポンスなどで使えるサンプルを提示します。
設定デフォルトとユーザー設定をマージして重複を適切に処理するケース
以下はデフォルト設定とユーザー設定をマージするケースです。文字列キーが重複する項目についてはユーザー設定を優先し、数値キーはそのまま保持する例です。
$configDefault = [ 'theme' => 'light', 'layout' => 'grid', 'plugins' => ['auth', 'cache'] ]; $configUser = [ 'theme' => 'dark', 'plugins' => ['seo'], 0 => 'additional_default' ]; $result = array_replace($configDefault, $configUser); // 結果には'theme'=>'dark', 'layout'はそのまま, 'plugins'はユーザーの配列で置き換え
このコードではarray_replace関数を使うことで、重複する文字列キーはユーザー設定が上書きされ、数値キーは維持されます。デフォルト値やオプションの上書き処理に適しています。
重複キーの値を配列にまとめる方法
キーの重複を避けるのではなく、重複があったときにそれら全ての値を残したい場合があります。そのような場合にはforeachを使って重複キーなら値を配列化する処理を入れます。
$result = [];
foreach ($array1 as $key => $value) {
$result[$key] = $value;
}
foreach ($array2 as $key => $value) {
if (isset($result[$key])) {
if (is_array($result[$key])) {
$result[$key][] = $value;
} else {
$result[$key] = [$result[$key], $value];
}
} else {
$result[$key] = $value;
}
}
この構造なら、重複したキーの値を配列にまとめて保持できます。ログや履歴、複数のソースからの入力を統合する際に便利なパターンです。
ネストされた配列を再帰的にマージする例
サブ配列がある場合、浅いマージでは上書きされてしまうので再帰的にマージする関数を用意すると良いです。以下は自作関数の例です。
function mergeRecursiveAssoc(array $arr1, array $arr2): array {
foreach ($arr2 as $key => $value) {
if (isset($arr1[$key]) && is_array($arr1[$key]) && is_array($value)) {
$arr1[$key] = mergeRecursiveAssoc($arr1[$key], $value);
} else {
$arr1[$key] = $value;
}
}
return $arr1;
}
$result = mergeRecursiveAssoc($array1, $array2);
この関数を使うと、キーごとにネストされた配列も統合され、重複したキーのサブ配列の内部までマージされます。設定ファイルや言語ファイルなどで構造が深いデータを扱う時に有効です。
比較表：array_merge など複数手段の挙動まとめ
ここで主要なマージ手段を比較した表を示します。重複キー時・数値キーの扱い・ネストの扱いなどをひと目で把握できます。
| メソッド | 重複する文字列キー | 数値キーの扱い | ネストされた配列のマージ |
|---|---|---|---|
| array_merge | 後の配列で上書きされる | 再番号付けされて０始まりの連番に | 浅いマージ。サブ配列が上書きされる |
| array_replace | 後の配列で上書きされる | 元の数値キーを保持する | 浅いマージ。ネスト配列は置き換え |
| + 演算子 | 重複時は左側を優先 | 数値キーをそのまま維持 | 浅いマージ。ネスト配列の挙動も置き換え主体 |
| array_merge_recursive | 重複値を配列としてまとめる | 数値キーの再番号付けされる | ネストレベルでマージが深く行われる |
トラブルシューティングとよくある疑問
実際に開発しているときに「思ったように配列がマージできない」「キーが消えてしまう」などのトラブルに直面することがあります。ここではよくある問題とその原因・解決策を整理します。
意図せず数値キーが変わってしまう問題
配列要素に数値キーを使っていたが、マージ後にキーが０始まりの連番に変更されてしまった、という事例は非常によくあります。これはarray_mergeの仕様で、数値キーは再番号付けされるためです。
解決策として数値キーを保持したいならば、+演算子を使うか、array_replaceなどを検討する、あるいはforeachでキーごとに処理する必要があります。
文字列キーの値が意図せず上書きされる問題
複数の配列に同じ文字列キーが含まれている場合、期待しない値で上書きされることが原因でバグになることがあります。特に設定やオプション類でこの状況が起きやすいです。
これを防ぐには、キーごとに存在チェックを入れるかarray_replaceではなく+演算子を使うか、重複時の値をまとめる自作処理を入れるなどの対策が有効です。
ネスト配列の深い統合ができない疑問
子配列の中身までマージしたいけれど、array_mergeだと後の配列がサブ配列を丸ごと置き換えてしまう、という問題があります。これは浅いマージだからです。
その場合はarray_merge_recursiveを使うか、自作の再帰関数を用意する以外に方法がありません。用途によってはネスト構造の整合性が重要なので、それらの関数を使うのが望ましいです。
いつどの手段を使うべきか：目的別おすすめの選択ガイド
全ての方法を知っていても、使いどころがわからなければ役に立ちません。ここでは目的ごとにどの手段を選べば良いかを整理します。
- 文字列キーで上書きして最新値を取得したい → array_merge または array_replace を使う
- 左側の値を保持したい（基準値など） → + 演算子 を使う
- 重複したすべての値を残したい → array_merge_recursive または 重複時に配列にまとめる自作ロジック
- ネストした構造を深く維持・統合したい → 再帰的マージ関数 を使う
- 数値キーをそのまま使いたい → + 演算子や array_replace を検討
まとめ
PHPのarray_mergeによる連想配列マージは便利ですが、文字列キーの重複で上書きが起こること、数値キーが再番号付けされること、ネストされた配列では浅いマージになることなどの仕様を理解することが重要です。これらの挙動を知らないと予期せぬバグが発生します。
重複キーを避けたり制御したい場合は、+演算子、array_replace、array_merge_recursive、自作の再帰関数などを状況に応じて使い分けると良いでしょう。目的に応じて適切な手段を選び、読みやすく安全なコードを書くことがマスターへの近道です。明確な要件に応じてこれらのテクニックを活用して行って下さい。
コメント