【PHP】配列に要素を追加する方法｜末尾・先頭・途中・結合パターンを完全解説

この記事でわかること

• 配列の末尾に追加する2つの方法（$arr[] と array_push()）
• 配列の先頭に追加する方法（array_unshift()）
• 特定の位置に挿入する方法（array_splice()）
• 配列同士を結合する3つの方法（array_merge()・スプレッド演算子・+ 演算子）
• 連想配列への要素追加と注意点
• よくあるミスと対処法

$fruits = ['apple', 'banana'];

// 末尾に要素を追加
$fruits[] = 'cherry';
$fruits[] = 'date';

echo '追加後の配列:' . PHP_EOL;
print_r($fruits);

追加後の配列:
Array
(
    [0] => apple
    [1] => banana
    [2] => cherry
    [3] => date
)

$arr[] は関数呼び出しのオーバーヘッドがないため、1つの要素を追加するだけなら最も高速な方法です。実務でもっとも多用されるパターンです。

// キーを明示的に指定した配列
$arr = [
    5 => 'A',
    10 => 'B',
];

$arr[] = 'C';

print_r($arr);
// [5] => A, [10] => B, [11] => C
// キー 10 の次なので 11 が割り当てられる

$colors = ['red'];

// 1つの要素を追加
array_push($colors, 'blue');

// 複数の要素を一度に追加
array_push($colors, 'green', 'yellow', 'purple');

print_r($colors);

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

array_push($array, $value1, $value2, ...);

// 引数:
//   $array  - 追加先の配列（参照渡し）
//   $value1 - 追加する値（1つ以上）
// 戻り値: 追加後の配列の要素数（int）

注意：array_push() の戻り値は追加後の要素数（整数）であり、配列そのものではありません。戻り値を変数に代入して配列として使おうとすると意図しない動作になります。

// $arr[] のベンチマーク
$arr1 = [];
$start = microtime(true);
for ($i = 0; $i < 100000; $i++) {
    $arr1[] = $i;
}
$time1 = microtime(true) - $start;

// array_push() のベンチマーク
$arr2 = [];
$start = microtime(true);
for ($i = 0; $i < 100000; $i++) {
    array_push($arr2, $i);
}
$time2 = microtime(true) - $start;

echo '$arr[]:     ' . round($time1 * 1000, 2) . ' ms' . PHP_EOL;
echo 'array_push: ' . round($time2 * 1000, 2) . ' ms' . PHP_EOL;

$arr[]:     3.42 ms
array_push: 5.18 ms

使い分けのポイント：1つの要素を追加するだけなら $arr[] を使いましょう。複数の要素をまとめて追加したい場合は array_push() が便利です。10万回のループでも数ミリ秒の差なので、通常の開発では可読性を優先して問題ありません。

$animals = ['dog', 'cat'];

// 先頭に1つ追加
array_unshift($animals, 'bird');

echo '1つ追加後:' . PHP_EOL;
print_r($animals);

// 先頭に複数追加
array_unshift($animals, 'fish', 'rabbit');

echo '複数追加後:' . PHP_EOL;
print_r($animals);

1つ追加後:
Array
(
    [0] => bird
    [1] => dog
    [2] => cat
)
複数追加後:
Array
(
    [0] => fish
    [1] => rabbit
    [2] => bird
    [3] => dog
    [4] => cat
)

array_unshift($array, $value1, $value2, ...);

// 引数:
//   $array  - 追加先の配列（参照渡し）
//   $value1 - 先頭に追加する値（1つ以上）
// 戻り値: 追加後の配列の要素数（int）

注意：array_unshift() は既存の数値キーを0から振り直します。文字列キー（連想配列のキー）は変更されません。大きな配列に対して頻繁に呼ぶと、キーの再割り当てによりパフォーマンスに影響する場合があります。

$user = [
    'name'  => '田中',
    'email' => 'tanaka@example.com',
];

// 先頭に 'id' を追加
$user = ['id' => 1] + $user;

print_r($user);

Array
(
    [id] => 1
    [name] => 田中
    [email] => tanaka@example.com
)

array_splice($array, $offset, $length, $replacement);

// 引数:
//   $array       - 対象の配列（参照渡し）
//   $offset      - 挿入・削除を開始する位置（0始まり）
//   $length      - 削除する要素数（0なら削除せずに挿入のみ）
//   $replacement - 挿入する要素（配列で指定）
// 戻り値: 削除された要素の配列

$months = ['1月', '2月', '4月', '5月'];

// インデックス2の位置に '3月' を挿入（削除なし）
array_splice($months, 2, 0, ['3月']);

print_r($months);

Array
(
    [0] => 1月
    [1] => 2月
    [2] => 3月
    [3] => 4月
    [4] => 5月
)

$nums = [1, 2, 6, 7];

// インデックス2の位置に 3, 4, 5 を挿入
array_splice($nums, 2, 0, [3, 4, 5]);

print_r($nums);
// [1, 2, 3, 4, 5, 6, 7]

$languages = ['PHP', 'Ruby', 'Perl', 'Go'];

// インデックス1から2つ削除し、Python と Java を挿入
$removed = array_splice($languages, 1, 2, ['Python', 'Java']);

echo '削除された要素:' . PHP_EOL;
print_r($removed);

echo '変更後の配列:' . PHP_EOL;
print_r($languages);

削除された要素:
Array
(
    [0] => Ruby
    [1] => Perl
)
変更後の配列:
Array
(
    [0] => PHP
    [1] => Python
    [2] => Java
    [3] => Go
)

array_splice() は元の配列を直接変更する（破壊的操作）ため、元の配列を保持したい場合は事前にコピーを取っておきましょう。

$frontend = ['HTML', 'CSS', 'JavaScript'];
$backend  = ['PHP', 'Python', 'Java'];

$all = array_merge($frontend, $backend);

print_r($all);

Array
(
    [0] => HTML
    [1] => CSS
    [2] => JavaScript
    [3] => PHP
    [4] => Python
    [5] => Java
)

$a = [1, 2];
$b = [3, 4];
$c = [5, 6];

$merged = array_merge($a, $b, $c);
print_r($merged);
// [1, 2, 3, 4, 5, 6]

array_merge() は元の配列を変更せず新しい配列を返す非破壊的な関数です。数値キーは0からリセットされます。

$fruits     = ['apple', 'banana'];
$vegetables = ['carrot', 'daikon'];

// スプレッド演算子で結合
$food = [...$fruits, ...$vegetables];

print_r($food);

Array
(
    [0] => apple
    [1] => banana
    [2] => carrot
    [3] => daikon
)

$base = [1, 2, 3];

// 結合 + 個別要素の追加を一度に
$extended = [0, ...$base, 4, 5];

print_r($extended);
// [0, 1, 2, 3, 4, 5]

注意：PHP 8.1 未満では、スプレッド演算子は数値キーの配列のみ対応しています。文字列キーを含む連想配列に使うとエラーになります。PHP 8.1 以降は連想配列でも使用可能です。

$defaults = [
    'color'  => 'blue',
    'size'   => 'medium',
    'weight' => 'normal',
];

$custom = [
    'color' => 'red',
    'style' => 'bold',
];

// $custom の値を優先し、不足分を $defaults で補完
$result = $custom + $defaults;

print_r($result);

Array
(
    [color] => red
    [style] => bold
    [size] => medium
    [weight] => normal
)

実務Tips：+ 演算子は「デフォルト値の補完」に最適です。ユーザー指定のオプションを左側、デフォルト値を右側に書くことで、指定されたものはそのまま、未指定のものはデフォルト値で埋める処理を簡潔に書けます。

$a = ['apple', 'banana'];      // キー: 0, 1
$b = ['cherry', 'date'];       // キー: 0, 1

$result = $a + $b;

print_r($result);

Array
(
    [0] => apple
    [1] => banana
)

$user = [
    'name' => '山田太郎',
    'age'  => 30,
];

// 新しいキーで追加
$user['email'] = 'yamada@example.com';
$user['phone'] = '090-1234-5678';

print_r($user);

Array
(
    [name] => 山田太郎
    日付未入力 => 30
    [email] => yamada@example.com
    [phone] => 090-1234-5678
)

注意：既に存在するキーに値を代入すると、上書きされます。追加ではなく更新になる点に注意してください。

$user = ['name' => '山田'];

// 同じキーに代入 → 上書き！
$user['name'] = '田中';

echo $user['name'];
// 田中（山田は上書きされた）

$config = [
    'debug' => true,
    'cache' => false,
];

// キーが存在しない場合のみ追加
if (!array_key_exists('timeout', $config)) {
    $config['timeout'] = 30;
}

// 既存のキーは上書きしない
if (!array_key_exists('debug', $config)) {
    $config['debug'] = false;  // この行は実行されない
}

print_r($config);

Array
(
    [debug] => 1
    [cache] =>
    [timeout] => 30
)

Null合体演算子の活用：PHP 7.0 以降では、??=（Null合体代入演算子、PHP 7.4〜）を使うと、キーが未定義またはnullの場合のみ代入できます。

$config = ['debug' => true];

// キーが存在しない or null の場合のみ代入（PHP 7.4〜）
$config['debug']   ??= false;  // 既存のため変更なし
$config['timeout'] ??= 30;     // 未定義のため 30 が代入される

print_r($config);
// ['debug' => true, 'timeout' => 30]

$default = [
    'host'    => 'localhost',
    'port'    => 3306,
    'charset' => 'utf8',
];

$custom = [
    'host'    => 'db.example.com',
    'charset' => 'utf8mb4',
];

$config = array_merge($default, $custom);

print_r($config);

Array
(
    [host] => db.example.com
    [port] => 3306
    [charset] => utf8mb4
)

$fruits = ['apple'];

// ❌ 間違い: 戻り値を配列として代入してしまう
$fruits = array_push($fruits, 'banana');

var_dump($fruits);
// int(2)  ← 配列ではなく要素数が入ってしまう！

$fruits = ['apple'];

// ✅ 正しい: 戻り値は代入しない（参照渡しで元の配列が変更される）
array_push($fruits, 'banana');

print_r($fruits);
// ['apple', 'banana']

$a = ['x' => 1];
$b = ['x' => 2, 'y' => 3];

// + 演算子: 左側の値を保持
$result1 = $a + $b;
echo '+ 演算子: x = ' . $result1['x'] . PHP_EOL;
// x = 1（$a の値が残る）

// array_merge(): 後の値で上書き
$result2 = array_merge($a, $b);
echo 'array_merge: x = ' . $result2['x'] . PHP_EOL;
// x = 2（$b の値で上書き）

$a = [10 => 'A', 20 => 'B'];
$b = [30 => 'C', 40 => 'D'];

// array_merge(): キーがリセットされる
$merged = array_merge($a, $b);
print_r($merged);
// [0]=>A [1]=>B [2]=>C [3]=>D

// + 演算子: キーが維持される
$union = $a + $b;
print_r($union);
// [10]=>A [20]=>B [30]=>C [40]=>D

// ❌ ループ内で array_merge() → 配列を毎回コピーするため遅い
$result = [];
foreach ($dataList as $data) {
    $result = array_merge($result, $data);
}

// ✅ スプレッド演算子で一度に結合
$result = array_merge(...$dataList);

// ✅ または、ループ内では $arr[] を使う
$result = [];
foreach ($dataList as $data) {
    foreach ($data as $item) {
        $result[] = $item;
    }
}

$users = [
    ['name' => '田中', 'age' => 25],
    ['name' => '山田', 'age' => 30],
];

// 新しいユーザーを追加
$users[] = ['name' => '佐藤', 'age' => 28];

// 既存のユーザーに項目を追加
$users[0]['email'] = 'tanaka@example.com';

print_r($users);

Array
(
    [0] => Array
        (
            [name] => 田中
            日付未入力 => 25
            [email] => tanaka@example.com
        )
    [1] => Array
        (
            [name] => 山田
            日付未入力 => 30
        )
    [2] => Array
        (
            [name] => 佐藤
            日付未入力 => 28
        )
)

迷ったときの選び方：
・1つの要素を末尾に追加 → $arr[] = 値
・複数要素をまとめて末尾に → array_push()
・先頭に追加 → array_unshift()
・途中に挿入 → array_splice()
・配列同士の結合 → array_merge() または [...$a, ...$b]
・デフォルト値の補完 → $custom + $defaults