配列

PHP array_merge関数の使い方と注意点を解説

2025-04-15更新日: 2025-04-15

PHPのarray_merge関数は複数の配列をひとつにまとめるために使われます。

たとえば、 $A = [1, 2]$ と $B = [3, 4]$ を結合すると、結果は $[1, 2, 3, 4]$ となります。

文字列のキー同士は上書きされ、数値キーの場合は連番に再割当てされる特徴があり、具体的な使い方や注意点について詳しく解説していきます。

目次から探す

PHP array_mergeの基本動作
- 基本仕様と挙動
- 再インデックスの仕組み
基本的な使用例
- 単一配列の結合例
- 複数配列のマージ方法
実践的なコード例
- サンプルコードによる確認
配列操作時の注意点
- 意図しない動作の回避策
他の配列操作関数との比較
- +演算子との違い
- その他配列関数との違い
まとめ

PHP array_mergeの基本動作

基本仕様と挙動

配列結合時の順序

PHPのarray_merge関数は、複数の配列を結合する際に、各配列の要素を指定した順序で連結します。

具体的には、最初の配列の要素が順番に登録され、その後に次の配列の要素が続けて追加される仕組みとなります。

そのため、結合する配列の並び順が最終的な結果に影響するため、配列の順序を意識して使用する必要があります。

文字列キーと数値キーの違い

array_merge関数では、キーの種類(文字列キーか数値キーか)によって動作が異なります。

・文字列キーの場合：後から結合された配列の同一キーがあれば、上書きされる仕様になっています。

・数値キーの場合：キーは再割当てされ、結果として連番のインデックスが自動的に振り直されるようになっています。

この動作の違いにより、意図しない上書きや順序の変化を招くことがあるため、キーの種類には注意が必要です。

再インデックスの仕組み

数値キーの再割当て詳細

array_mergeを用いると、数値キー配列のキーは新たに0からの連番に再割当てされます。

つまり、もともとの配列の数値キーは保持されず、結合後の配列では順序が自動的に整列されます。

例えば、配列$arr1 = [1 => 'A', 3 => 'B']と$arr2 = [2 => 'C']を結合すると、結果は

['A', 'B', 'C']

というように、キーが0, 1, 2に振り直されるため、元のキー情報は失われます。

基本的な使用例

単一配列の結合例

シンプルなコードサンプル

以下は、シンプルな配列結合の例です。

この例では、二つの配列を結合して一つの配列にまとめています。

<?php
// 配列の定義(文字列キーの場合)
$array1 = ['key1' => 'value1', 'key2' => 'value2'];
$array2 = ['key3' => 'value3', 'key4' => 'value4'];
// array_mergeによる結合
$result = array_merge($array1, $array2);
// 結合結果の出力
print_r($result);
?>

Array
(
    [key1] => value1
    [key2] => value2
    [key3] => value3
    [key4] => value4
)

複数配列のマージ方法

配列同士の統合時の注意点

複数の配列を統合する際には、各配列のキーの重複に注意が必要です。

文字列キーが重複している場合、後から追加された配列の値で上書きされます。

数値キーの場合は、再インデックスが行われるため、元のキーの順序が保たれなくなります。

以下の例は、重複するキーを持つ配列を結合した場合の動作を示しています。

<?php
// 配列の定義(文字列キーが重複する場合)
$arrayA = ['name' => 'Alice', 'age' => 30];
$arrayB = ['name' => 'Bob', 'city' => 'Tokyo'];
// array_mergeによる結合
$resultMerge = array_merge($arrayA, $arrayB);
// 結合結果の出力
print_r($resultMerge);
?>

Array
(
    [name] => Bob
    [age] => 30
    [city] => Tokyo
)

実践的なコード例

サンプルコードによる確認

キー上書きの実例

文字列キーが重複した場合の動作を実際のコードで確認します。

以下のサンプルコードでは、重複するキー'status'の値が上書きされることを確認できます。

<?php
// 配列の定義
$defaultSettings = [
    'theme'  => 'light',
    'status' => 'inactive'
];
$userSettings = [
    'status' => 'active',  // デフォルトの'status'を上書きする
    'lang'   => 'ja'
];
// array_mergeによる結合
$mergedSettings = array_merge($defaultSettings, $userSettings);
// 結合結果の出力
print_r($mergedSettings);
?>

Array
(
    [theme] => light
    [status] => active
    [lang] => ja
)

エラー発生ケースの対処方法

array_mergeでは基本的にエラーは発生しにくいですが、結合対象に配列以外が含まれている場合、予期しない動作をする可能性があります。

以下の例では、結合対象が配列ではない場合の挙動を示しています。

<?php
// 配列と非配列が混在する例
$arrayData = ['a', 'b'];
$nonArrayData = 'This is a string';
// エラーを回避するため、is_arrayでチェックを行う
if (is_array($nonArrayData)) {
    $merged = array_merge($arrayData, $nonArrayData);
} else {
    // 非配列の場合は結合せず、配列のみの統合を実行
    $merged = $arrayData;
}
// 結合結果の出力
print_r($merged);
?>