錯誤類型對照
| 錯誤訊息 | 類型 | 原因 |
| Notice: Undefined variable: $var | E_NOTICE | 使用未定義的變數 |
| Notice: Undefined index: "key" | E_NOTICE | 陣列不存在該鍵名 |
| Notice: Undefined offset: 0 | E_NOTICE | 數字索引陣列不存在該索引 |
| Warning: Undefined array key "key" | E_WARNING (PHP 8.0+) | 同上,等級提升 |
常見觸發情境
1. 直接使用未初始化變數
<?php
if ($user['name'] === 'admin') { ... } // $user 可能未定義
// Notice: Undefined variable: user
2. 陣列鍵不存在
3. 多維陣列鏈式存取
解決方案對比
| 方法 | 語法 | 適用場景 | 優點 | 缺點 |
| 預先定義 | $var = ''; | 明確預設值 | 程式碼清晰 | 重複代碼 |
| isset() | isset($arr['key']) | 檢查存在才存取 | 無警告、快 | 值為 null 視為不存在 |
| array_key_exists() | array_key_exists('key', $arr) | 需區分 null 值 | 精確檢查鍵存在 | 較慢 |
| null 合併運算子 | $arr['key'] ?? 'default' | 提供預設值 (PHP 7+) | 簡潔、一行搞定 | 不檢查更深層 |
| ??= 賦值 | $arr['key'] ??= 'default' | 不存在才設定 (PHP 7.4+) | 冪等初始化 | |
| @ 抑制錯誤 | @$arr['key'] | 快速修補舊代碼 | 簡單 | 效能差、隱藏真錯誤、不推薦 |
| error_reporting | error_reporting(E_ALL & ~E_NOTICE) | 全域關閉 Notice | 一次解決 | 掩蓋真正 Bug、不推薦生產環境 |
現代最佳實務 (PHP 7.4+)
單層陣列:?? 預設值
多層陣列:?-> 鏈式存取 (PHP 8.0+)
address?->city ?? 'Unknown';
// 等同於:
$city = isset($user['address']['city']) ? $user['address']['city'] : 'Unknown';
舊版 PHP 多層安全存取
表單處理模式
trim($_POST['name'] ?? ''),
'email' => trim($_POST['email'] ?? ''),
'age' => isset($_POST['age']) ? (int)$_POST['age'] : null,
];
// 驗證
if ($input['name'] === '') $errors['name'] = '必填';
if ($input['email'] !== '' && !filter_var($input['email'], FILTER_VALIDATE_EMAIL)) {
$errors['email'] = '格式錯誤';
}
開發環境建議設定
除錯技巧
根治策略:型別系統 + 靜態分析
總結
- 開發環境開啟 E_ALL,盡早發現問題
- 輸入層統一處理:
$_GET['key'] ?? 'default'
- 業務邏輯用嚴格判斷:
=== null, isset(), array_key_exists()
- 避免 @ 抑制 與 error_reporting 關閉 Notice
- 善用 PHPStan/Psalm 靜態分析預防