💡 忙しい人のための結論(3行まとめ)
  • 存在しない配列キー(未定義インデックス)へ直接アクセスした際に発生し、PHP 8.0以降で従来の Notice から Warning(警告)へ格上げされました。
  • 未定義時に初期値を入れたい場合は Null合体演算子($array['key'] ?? '初期値')、条件分岐したい場合は isset() を使います。
  • 配列の値に「正当な null」が入る可能性がある場合(DB取得値やJSON API等)は、isset() ではなく array_key_exists() で判定します。

1. 発生する症状・やりたいこと(前提条件)

PHP 7系からPHP 8.xへバージョンアップした現場や、フォーム送信・外部API連携の実装時に最も頻繁に遭遇する警告です。Laravel等のフレームワーク環境では Warning も例外(ErrorException)に変換されて処理が停止するため、確実なガードが必須となります。

  • 未チェックのチェックボックス($_POST)や、省略可能なURLパラメータ($_GET)を直接参照したとき
  • 外部APIのJSONレスポンスで、条件によって省略されるキーやネスト要素にアクセスしたとき
  • PHP 7.4以前では無視されていた Notice: Undefined index が、PHP 8.0以降で Warning に昇格して顕在化したとき
Warning: Undefined array key "coupon_code" in /var/www/html/checkout.php on line 14
Warning: Trying to access array offset on null in /var/www/html/checkout.php on line 15

2. ❌ やりがちなNGコード vs ⭕ 実務で使える正解コード

まずは警告を発生させる典型的なNGコードと、PHP 8.3 / 8.4準拠の安全な正解コードを比較します。

❌ やりがちなNGコード(バグ・警告の原因)Before
<?php
// 1. キーの存在を確認せず直接アクセス(未送信時に Warning 発生)
$coupon = $_POST['coupon_code'];

// 2. 親キーが未定義だと null への配列アクセス警告も連鎖して発生
$city = $apiResponse['user']['address']['city'];

// 3. エラー制御演算子(@)による握りつぶしは重大なバグを隠蔽するため厳禁
$page = @$_GET['page'];

未定義キーへの直接アクセスは Undefined array key を出すだけでなく、戻り値の null に対してさらに配列アクセスを行うと Trying to access array offset on null を連鎖的に引き起こします。また、@ 演算子による警告の握りつぶしはパフォーマンス劣化とデバッグ困難を招くため実務では避けてください。

⭕ コピペで動く実務の正解コード(PHP 8.3/8.4対応)After
<?php
declare(strict_types=1);

// 1. 基本:Null合体演算子(??)で未定義・null時に安全な初期値を設定
$coupon = (string) ($_POST['coupon_code'] ?? '');
$page   = max(1, (int) ($_GET['page'] ?? 1));

// 2. 多次元配列:途中の階層が欠けていても ?? なら警告なしで安全に評価される
$city = $apiResponse['user']['address']['city'] ?? '未登録';

// 3. 集計処理:Null合体代入演算子(??=)で未定義キーの初期化と加算を安全に行う
$counts = [];
foreach (['apple', 'banana', 'apple'] as $item) {
    $counts[$item] ??= 0;
    $counts[$item]++;
}

// 4. 値に「null」が入る可能性がある場合(JSONやDB行)は array_key_exists() を使う
$payload = ['nickname' => null]; // 明示的にnullでリセットしたいリクエスト
if (array_key_exists('nickname', $payload)) {
    // isset() だと false になるが、array_key_exists() なら「キー指定あり」と正しく検知できる
    $nickname = $payload['nickname']; // null のまま安全に取得
}

3. 仕様・使い分けの比較早見表

PHPで配列キーの存在や値をチェックする4つの手法は、「値が null や '0' のときにどう判定されるか」が決定的に異なります。用途に合わせて以下の表から選択してください。

方法 / 関数 キー未定義 値が null 値が '' / '0' / 0 おすすめな場面
$a['k'] ?? '初期値' 初期値を返す
(警告なし)
初期値を返す そのままの値を返す 【最優先】 未定義や null のときにデフォルト値へフォールバックしたい場面
isset($a['k']) false
(警告なし)
false true キーが存在し、かつ中身が null ではないことを確認して条件分岐したい場面
array_key_exists('k', $a) false
(警告なし)
true true DBレコードやPATCH APIなど、「キー未指定」と「値が null」を厳密に区別したい場面
!empty($a['k']) false
(警告なし)
false すべて false 空文字も弾きたい場面(※数値の 0 や文字列 '0' も弾かれる点に要注意)

4. 実務でハマりやすい3つの注意点

1empty() を使うと文字列の '0' や数値 0 まで未入力扱いになる

フォーム入力で「0個」「0歳」が送信された場合、!empty($_POST['age']) で判定すると '0' が false と評価され、未入力と同じ分岐に入ってしまいます。未定義を防ぎつつ空文字だけを弾きたい場合は ($_POST['age'] ?? '') !== '' と明示的に比較してください。

2値が null のキーに対して isset() と ?? は「存在しない」と判定する

JSONのデコード結果({"memo": null})やDBのNULLカラムでは、キー自体は存在していても isset($row['memo']) は false を返します。「キー自体が送られてこなかった」のか「明示的に null が送られた」のかを区別するAPI実装では、必ず array_key_exists('memo', $row) を使用してください。

3多次元配列は ?? なら一括で辿れるが、array_key_exists() は1階層ずつ必要

$data['user']['profile']['bio'] ?? '未設定' のように ?? や isset() を使う場合は、途中の 'user' キーが存在しなくても警告なしで評価されます。一方、array_key_exists() は対象配列の直下1階層しか検査できないため、深い階層で使う際は親要素が is_array() であることを先に確認してください。

5. よくある質問(FAQ)

Q. PHP 7では動いていたのに、PHP 8に上げたら急にエラーで止まるのはなぜですか?

PHP 7.4までは未定義キーへのアクセスは軽微な E_NOTICE(Notice: Undefined index) でしたが、PHP 8.0から E_WARNING(Warning: Undefined array key) に格上げされたためです。Laravelなどのフレームワークや本番のエラーハンドラが E_WARNING を例外(ErrorException)として捕捉する設定になっていると、その場で処理が中断されます。

Q. php.ini の error_reporting で Warning を非表示にして乗り切るのはアリですか?

本番障害の温床になるため非推奨です。E_WARNING を無効化すると、ファイル読み書きの失敗や型不整合など他の重大な実行時警告まですべて検知できなくなります。レガシーコードの移行時は、RectorやPHPStanなどの静的解析ツールを活用して ?? 演算子へ段階的に置換するのが安全です。

Q. 「Trying to access array offset on value of type null」という警告も同時に出るのですが?

1段階目の配列アクセス(例:$user = $data['user'])が未定義で null になったまま、続けて $user['name'] のように配列アクセスを行った際に発生します(PHP 8.4では Trying to access array offset on null と表示されます)。$data['user']['name'] ?? '' とチェーン全体を ?? で受けるか、親要素を $user = $data['user'] ?? []; で空配列に初期化すれば同時に解消できます。