配列

PHP 配列に別の配列を追加する方法を解説

2025-02-20更新日: 2025-02-20

PHPで配列に別の配列を追加する方法を、具体例を交えながらご紹介します。

配列操作の基本的な手順やコツをシンプルにまとめ、実践的に活用できる内容となっています。

初心者の方はもちろん、基本操作を理解している方にも役立つ情報を提供します。

目次から探す

PHP配列の基本操作
- 配列の概念と特徴
- PHPにおける配列の初期化
配列に別の配列を追加する方法
- array_merge関数による追加
- スプレッド演算子による追加
実践例と応用ケース
- 複数配列の統合シナリオ
注意点とトラブルシューティング
- キーの重複問題への対処
- パフォーマンスへの影響と最適化方法
まとめ

PHP配列の基本操作

配列の概念と特徴

PHPの配列は数値添字(インデックス)や文字列添字(連想キー)を利用して複数の値を格納するコレクションです。

配列は同じデータ型に限定されず、異なる型の値を混在させることが可能です。

また、配列の要素は動的に追加や削除することができ、柔軟なデータ構造として利用されます。

例えば、数値添字の場合と連想配列の場合があり、用途に応じて適切な方式を選択できます。

キーと値のペアで管理されるため、キーに基づいたデータの参照・更新が容易です。

PHPにおける配列の初期化

PHPでは、配列の初期化方法として主に二通りの記法があります。

従来の記法はarray()関数を利用する方法で、PHP 5.4以降は[]と簡略記法を利用することができます。

例えば、数値添字の配列は以下のように初期化できます：

<?php
// array() を使った初期化
$numbers_old = array(1, 2, 3);
// 簡略記法を使った初期化
$numbers_new = [1, 2, 3];
// 連想配列の初期化例
$userInfo = [
    'name' => '太郎',
    'age'  => 25,
    'city' => '東京'
];
echo $numbers_new[0]; // 1を出力します
?>

配列に別の配列を追加する方法

PHPでは既存の配列に対して別の配列を追加する手法として、主に array_merge関数とスプレッド演算子が利用されます。

それぞれの手法には特徴と注意点があるため、適切な状況に応じて選択することが推奨されます。

array_merge関数による追加

array_mergeの基本書式

array_merge関数は二つ以上の配列を連結し、一つの新しい配列として返します。

基本的な書式は以下の通りです：

$newArray = array_merge($array1, $array2, ...);

この関数は数値添字の配列の場合、添字を再構成して0から連番に振り直します。

連想配列の場合は、同じキーが存在する場合、後の配列の値で上書きされます。

実例による動作確認

具体的な例として、二つの配列をarray_mergeで連結する方法をご紹介します。

<?php
// 1つ目の配列
$fruits = ['apple', 'banana'];
// 2つ目の配列
$moreFruits = ['orange', 'grape'];
// array_mergeを用いて配列を連結
$allFruits = array_merge($fruits, $moreFruits);
// 結果を出力
print_r($allFruits); // 数値添字が自動的に再割り当てされます
?>

Array
(
    [0] => apple
    [1] => banana
    [2] => orange
    [3] => grape
)

スプレッド演算子による追加

スプレッド演算子の概要

PHP 7.4以降、スプレッド演算子...を利用して配列を展開し、簡潔に結合することができます。

スプレッド演算子を利用すると、配列内に他の配列の要素を直接展開でき、シンプルな構文で配列の追加が可能となります。

使用時の注意点

スプレッド演算子では、必ず配列全体が展開され、キーは固定されず数値添字の場合はリセットされるため、連想配列の場合はキーを明示的に管理する必要があります。

また、キーの重複が発生した場合は最初の配列側の値が維持される場合があるため注意が必要です。

以下にスプレッド演算子を利用した例を示します。

<?php
// 1つ目の配列
$colors = ['red', 'blue'];
// 2つ目の配列
$moreColors = ['green', 'yellow'];
// スプレッド演算子を用いて配列を追加
$allColors = [...$colors, ...$moreColors];
// 配列の内容を出力
print_r($allColors);
?>

Array
(
    [0] => red
    [1] => blue
    [2] => green
    [3] => yellow
)

実践例と応用ケース

複数配列の統合シナリオ

実践的な場面では、複数の配列を組み合わせて一つの配列に統合するケースが多く発生します。

ここでは、単純な配列の連結方法とネストした配列の追加手法について紹介します。

単純な配列の連結方法

数値添字の配列の場合、array_merge関数やスプレッド演算子を利用することで簡単に統合できます。

以下は、二つの数値入り配列を連結する例です。

<?php
// 数値が格納された配列
$list1 = [10, 20, 30];
$list2 = [40, 50];
// array_mergeを使った連結
$mergedList1 = array_merge($list1, $list2);
print_r($mergedList1);
// スプレッド演算子を使った連結
$mergedList2 = [...$list1, ...$list2];
print_r($mergedList2);
?>

Array
(
    [0] => 10
    [1] => 20
    [2] => 30
    [3] => 40
    [4] => 50
)
Array
(
    [0] => 10
    [1] => 20
    [2] => 30
    [3] => 40
    [4] => 50
)

ネスト配列の追加手法

ネストされた配列を扱う場合、単にarray_mergeやスプレッド演算子を使うだけでは期待通りにマージできない場合があります。

このような場合は、再帰的に配列をマージする方法や、専用の関数を用いることを検討します。

以下は、再帰的に配列をマージするシンプルな例です。

<?php
// 再帰的にマージする関数の例
function recursive_merge(array $base, array $additional): array {
    foreach ($additional as $key => $value) {
        // もし同じキーが存在し、かつ値が配列の場合は再帰的にマージ
        if (isset($base[$key]) && is_array($base[$key]) && is_array($value)) {
            $base[$key] = recursive_merge($base[$key], $value);
        } else {
            // それ以外は上書き
            $base[$key] = $value;
        }
    }
    return $base;
}
$nested1 = [
    'user' => [
        'name' => '太郎',
        'hobby' => ['読書', '散歩']
    ]
];
$nested2 = [
    'user' => [
        'age' => 30,
        'hobby' => ['旅行']
    ]
];
// 再帰的に配列をマージ
$mergedNested = recursive_merge($nested1, $nested2);
print_r($mergedNested);
?>

Array
(
    [user] => Array
        (
            [name] => 太郎
            [hobby] => Array
                (
                    [0] => 旅行
                )
            [age] => 30
        )
)