PHPで配列に値を追加する方法

PHPで配列に値を追加する方法を紹介します。

この記事では、PHPでは配列に追加する方法を４つ解説します。
それぞれ気を付けたいポイントがありますので、動きの違いも合わせてチェックしてください。

• [] で追加する方法
• array_push関数で追加する方法
• +（プラス）演算子で追加する方法
• array_unshift関数で先頭に追加する方法

配列に追加する方法はいくつかありますが配列追加はよく使う構文です。

この機会にぜひマスターしましょう！

array_push関数で追加

配列に値を追加するときに使用する関数がPHPで用意されています。

「追加先の配列」に対して、値を渡すことで配列の後ろに追加できます。（複数OK）

array_push(追加先の配列, 追加する値...)

引数	第１引数：追加先の配列（array）
	第２引数：追加する値　※可変引数なので、複数OK
戻り値	追加後の配列数（int）

さっそくarray_push関数を使ってみましょう。
コピーして実行してみてください。

<?php
 
// 追加先
$fruitsArray = ['バナナ', 'イチゴ'];
 
// 追加先に「スイカ、メロン」を追加する
array_push($fruitsArray, 'スイカ', 'メロン');
 
print_r($fruitsArray);
 
?>

出力結果：

このように配列に「スイカ、メロン」が追加されました。

気をつけたいポイント

array_push関数で追加した配列は、戻り値ではなく第１引数に指定した配列に直接追加されます。

+（プラス）演算子で追加

+（プラス）演算子で配列追加する方法です。
先ほどとは違い、配列にキーをつけています。

<?php
 
// 追加先
$fruitsArray = [0 => 'バナナ', 1 => 'イチゴ'];
 
// これから追加する配列 ※追加先とは別のキーを指定
$arr = [2 => 'スイカ', 3 => 'メロン'];
 
// 追加先に、+ 演算子で配列を追加
$total = $fruitsArray + $arr;
 
print_r($total);
 
?>

出力結果：

「2：スイカ、3：メロン」が追加されました。

気をつけたいポイント

+（プラス）演算子を使うときは、同じキーの配列は追加されないので注意が必要です。

異なるキーをつけるようにしてください。

例えば、次のように配列にキーをつけない場合は追加されません。

<?php
 
// キーは指定していないが、PHPでは「0 => 'バナナ', 1 => 'イチゴ'」と解釈される
$fruitsArray = ['バナナ', 'イチゴ'];
 
// 「0 => スイカ」と解釈される
$arr = ['スイカ'];
 
// すでに追加先に「0 => 'バナナ'」があるので、「スイカ」は追加されない
$total = $fruitsArray + $arr;
print_r($total);
 
?>

出力結果：

すでに「0：バナナ」があるので、「スイカ」は追加されません。

[]（カッコ） で追加

[]（カッコ） で配列追加する方法です。

<?php
 
// 追加先
$fruitsArray = ['バナナ', 'イチゴ'];
 
// 値を追加
$fruitsArray[] = 'スイカ';
 
print_r($fruitsArray);
 
?>

出力結果：

「スイカ」が追加されました。

気をつけたいポイント

[]（カッコ） で追加の気をつけたいポイントとしては、配列に値を１つずつしか追加できないところです。

array_unshift関数で先頭に追加

最後にarray_unshift関数の使い方を解説します。

array_push関数が配列の後ろに追加されましたが、array_unshift関数は配列の先頭に追加されます。

使い方はarray_pushと同じ使い方です。
さっそく使い方を見てみましょう。

<?php
 
// 追加先
$fruitsArray = ['バナナ', 'イチゴ'];
 
// 追加先の先頭に「スイカ、メロン」を追加
array_unshift($fruitsArray, 'スイカ', 'メロン');
 
print_r($fruitsArray);
  
?>

出力結果：

「バナナ」より前に「スイカ、メロン」が追加されました。

気をつけたいポイント

あまり使われない関数で、array_pushとは違ってPHPに慣れていない開発者がarray_unshiftは関数名だけで配列追加すると理解しにくい点があります。

まとめ

いかがだったでしょうか。

今回はPHPで配列に値の追加方法について解説しました。

• array_push関数で追加する方法
• +（プラス）演算子で追加する方法
• [] で追加する方法
• array_unshift関数で先頭に追加する方法

開発現場では、配列を使う処理はよく使いますので、ぜひ覚えましょう！

それぞれ配列追加の動きが違いますので、気をつけたいポイントをよく理解して目的のあった方法を選びましょう。

---