PHPで配列にunsetを使うとどうなる？要素削除の挙動と注意点を解説

配列から特定の要素を取り除きたいとき、PHPで使われる代表的な方法が unset関数 です。ですが、unsetを使うと「キーの欠落」「インデックスが飛ぶ」「参照やメモリの扱い」など、思わぬ挙動に戸惑うことがあります。この記事では、PHPの配列にunsetを使った場合の正確な動作、押さえておくべき注意点、実用的な使い方などを最新情報を踏まえて詳しく解説します。配列操作で悩んだ時の頼れるガイドとなる内容です。

PHP unset 配列 の基本的な動作とは

まず、unsetを使ったときにPHPの配列で何が起こるのか、明確に説明します。配列に対するunsetは、指定したキーまたはインデックスの要素を完全に削除しますが、その配列オブジェクト自体は残ります。つまり、指定した要素だけが「存在しない」状態になるのです。
このとき注意すべきは、削除した要素のキーが飛んでしまうことで、数値インデックス配列では0,1,2…が連続でなくなるケースがあります。
また、unsetされた参照やオブジェクトの扱いとして、参照が残るとメモリが解放されないことがあるので、その点も把握しておく必要があります。

配列要素の削除方法とその結果

例として数値インデックスの配列でunsetを使うとき、指定したインデックスの要素だけが除去され、残る要素のインデックスはそのまま維持されます。つまり連番が崩れることがあります。
一方、連想配列（キーが文字列などの場合）はキーを指定して削除することにより、そのキーと値のペアがなくなります。こちらも他のキーに影響を与えず、キーがそのままの順序で残ります。連想配列ではキーが意味を持つため、この挙動の方が期待通りになることが多いです。

数値キーの穴（キーのギャップ）が生じる理由

PHPの配列は内部的には順序付きマップ構造で、キーと値がペアになっています。unsetを使って要素を削除しても、「キー」の再割り当ては自動では行われません。数値インデックス配列においては、これが「穴」ができる理由です。
この穴はforループでインデックスを基準に要素にアクセスする場合や、JSONエンコード時に配列ではなくオブジェクトになってしまう場合など、予期せぬ問題を引き起こすことがあります。

参考：公式ドキュメントでのunset挙動の定義

公式ドキュメントでは、unsetは変数、配列の要素、オブジェクトプロパティなどを削除する言語構造として定義されています。配列要素をunsetした場合、指定したキーが消え、配列の残りの部分はそのまま残ると記載されています。
参照変数との関係では、unsetはその名前とコンテンツの結びつきを切るもので、参照が他にも存在するなら、その内容自体は残ることがあります。こうした挙動はコードで明示的に扱うことが望ましいです。

PHP unset 配列 を使う際の応用シナリオと再インデックスの必要性

unsetで要素を削除するだけではキーの連続性は保たれません。シナリオによってはそのギャップが問題になることがあります。ここでは、再インデックス（array_valuesなど）を使うべき場合と、使わなくてもよい場合を紹介します。実用的なケースを踏まえておくことで、予期せぬバグを防ぐことができます。

再インデックスが必要になる場面

数値インデックスでのループ処理を使うケースでは、キーのギャップがエラーや無視される要素を生むことがあります。JSON APIに渡すとき、クライアント側で配列ではなくオブジェクトとして扱われることがあります。
また、フロントエンドや他の言語で配列の連続性が前提となるライブラリを使う場合には、array_valuesを使ってインデックスを再割り当てすることが推奨されます。

再インデックスが不要な場面

foreachやkeyを使ったアクセスでは、キーにギャップがあっても問題にならないことが多いです。キーが意味を持つ文字列なら順序や連番ではなく、キー名そのものが重要です。
また、大きな配列で頻繁に再インデックスするとパフォーマンスコストがかかるため、不要であれば避けることで効率が改善します。配列サイズが大きいときには特にこの点を意識すべきです。

array_valuesと他の関数との組み合わせ例

array_valuesは配列の全ての値を取り出し、数値インデックスを0から振り直してくれる関数です。unset後のギャップを解消するためによく使われます。
また、array_filterで条件に合う要素を残す形式の処理を行い、そのあとarray_valuesで再インデックスすることで、シンプルで読みやすいコードになります。この2段階処理はJSONシリアライズ前などで特に有用です。

PHP unset 配列 による参照とメモリの扱い

unsetは単に変数名やキー名から値を切り離す操作ですが、内部的なメモリ解放や参照の挙動も理解しておくべきです。特にオブジェクト・参照変数・静的変数などとの組み合わせで意外な動作を示すことがあります。最新のPHPバージョンでもこの点は基本的に変わっていません。

参照変数に対するunsetの影響

変数同士が参照で結びついている場合、unsetを使って名前の参照を切っても、参照先の内容が全てなくなるわけではありません。他の変数がその内容を参照していれば、値は残ります。
例えば$aと$bが同じ内容を参照していた状態でunset($a)を実行すると、$aは消えますが$bは内容を保持します。参照の切断と値の破棄は異なる概念です。

オブジェクトプロパティや変数範囲でのunset

オブジェクトのプロパティであっても、unsetを使えばプロパティが削除されます。ただし、オブジェクト自身がまだスコープに残っている参照を持っていれば、そのインスタンス自体はガーベジコレクションの対象とはなりません。
また、関数の中でunsetを使ってグローバル変数を消そうとした場合、まずはローカルなスコープで扱われるため、意図通りに消えないケースがあります。この点も覚えておくとトラブル防止になります。

静的変数での挙動と復帰性

関数のstatic変数をunsetした際には、その関数の実行中に参照や値が削除されますが、次回関数が呼ばれると静的変数の状態が復元されるような挙動を示すことがあります。言い換えれば、static宣言による持続性がunsetによって完全に破棄されるわけではないということです。意図した挙動を得るには設計上その点を考慮する必要があります。

PHP unset 配列 を使った具体的なコード例と比較

ここでは、unsetを使った処理をいくつか具体例で見てみます。それぞれ「キーが飛ぶ」「再インデックス」「JSON変換時の違い」など、実際に遭遇しうるシチュエーションを含んでいます。サンプルコードで動きを確認すると理解がより深まります。

数値インデックス配列でのunsetとarray_valuesの組み合わせ

以下の例を見て下さい。
php
$fruits = [ "apple", "banana", "cherry", "date" ];
unset($fruits[1], $fruits[3]);
// $fruitsは [0 => "apple", 2 => "cherry"]
$fruits = array_values($fruits);
// 再インデックス後は [0 => "apple", 1 => "cherry"]

unsetだけではキー1とキー3が消え、連続性がなくなります。array_valuesを使うことで0始まりの連番に戻ります。JSONやループでの見通しが良くなります。

連想配列でのキー削除例と残る構造

連想配列ではキー名が意味を持つため、例えば設定の配列やユーザ情報などで使われます。
php
$user = [ "id" => 123, "name" => "Alice", "email" => "alice@example" ];
unset($user["email"]);
// 結果は [ "id" => 123, "name" => "Alice" ]

こちらはキー「email」が消えるだけで、他のキーと値の順序や構造はそのまま維持されます。

JSON化とforループでの問題発生例

次のようなケースを想像して下さい。
php
$data = [ "apple", "banana", "cherry" ];
unset($data[0], $data[1]);
$data[] = "date";
echo json_encode($data);

unset後はキーのギャップがあり、新たな追加でキーが前の最大数の次の整数になります。このため、json_encodeするとオブジェクト形式になることがあります。forを使ったアクセスも欠損キーでNoticeが出たりします。

PHP unset 配列 に関するパフォーマンスと落とし穴

unsetを乱用するとパフォーマンスに影響することがあります。また、扱いを誤るとバグの原因となる落とし穴も存在します。特に大きな配列や頻繁な削除処理、参照が絡む場面では注意が必要です。ここを理解しておくことで、安全かつ効率的なコードが書けます。

大量配列でのunsetコストとメモリの挙動

大きな配列で多くの要素をunsetすると、それぞれの要素が内部的に削除処理を行いますが、配列の内部構造がスパース（キーにギャップがある状態）になることが多くなります。
また、unsetされた要素のメモリが即座にOSに返されるとは限らず、PHP内部のガーベジコレクトやzvalメモリ管理に依存します。パフォーマンスを検証する際はメモリ使用量や処理時間を計測するのが望ましいです。

参照やスコープからの影響で起きる想定外の動作

関数スコープの変数、静的変数、グローバル変数、参照変数などによって、unsetが思い通りに値を消さないように見える状況があります。
特に参照変数で変数名の参照を切っても、参照先が他の変数で使われていればそこには値が残ることがあります。これを誤解してデバッグが長引くことがあります。

暗黙的なキー名の再生成と配列[]追加時の動き

unsetで値を削除したあと、配列に新しい要素を [] で追加するとき、数値インデックス配列では最後に使われた数値キーの最大値 +1が新しいキーになります。欠番があるとそこを埋めることはしません。
そのため、ギャップが残っていても、次の数値キーは既存の最大数値キーから算出され、ユーザの期待とは異なるキーが割り当てられることがあります。

他の削除方法との比較：unset vs array_splice vs array_filter など

配列要素の削除にはunsetだけでなく、array_spliceやarray_filterなどを使う手法があります。それぞれ特性が異なるため、状況に応じて使い分けることが望ましいです。以下に比較表を示します。

まとめ

PHPで配列にunsetを使うときは、キーの削除、ギャップの発生、参照やメモリの扱いなどを正しく理解しておくことが非常に重要です。数値インデックス配列でforループやJSON出力が絡む場面では特にギャップが問題になります。
再インデックスが必要な場合にはarray_valuesを適切な場所で使うこと、連想配列ではキー名が意味を持つのでそのまま使うのがよいこと。参照変数や静的変数など、スコープとの組み合わせで挙動が複雑になる点にも注意が必要です。
unsetはシンプルで強力な関数ですが、その性質を理解して使うことで、配列操作でのバグを減らし、可読性や保守性の高いコードを書くことができます。