PHP "Undefined index/variable" Notice 錯誤徹底解決指南

PHP 開發中最常見的 Notice: Undefined index 和 Notice: Undefined variable 並非致命錯誤，但會污染日誌、暴露代碼缺陷，甚至干擾 AJAX/JSON 輸出。本文提供從代碼規範到配置調優的分級解決方案。

錯誤成因分析

• Undefined index：訪問陣列不存在的鍵，如 $_POST['act'] 但表單未提交 act
• Undefined variable：使用未賦值的變量，如直接 echo $var 但 $var 從未定義

方案一：代碼層面規範（根治，推薦）

1. 陣列鍵存在性檢查

<?php
// 三元運算符
$act = isset($_POST['act']) ? $_POST['act'] : 'default';

// Null 合並運算符 (PHP 7+)
$act = $_POST['act'] ?? 'default';

// filter_input (最規範，自動過濾)
$act = filter_input(INPUT_POST, 'act', FILTER_SANITIZE_STRING, ['default' => 'default']);
?>

2. 變量預先初始化

<?php
// 函數/腳本開頭初始化
$name = $email = $content = '';
// 或陣列批量
$data = ['name' => '', 'email' => '', 'content' => ''] + $_POST; // 合併默認值
?>

3. 封裝安全獲取函數

<?php
function get($array, $key, $default = '') {
    return isset($array[$key]) ? $array[$key] : $default;
}
$act = get($_POST, 'act');
$page = get($_GET, 'page', 1);
?>

方案二：錯誤報告級別調整（治標，快速）

1. php.ini 全局配置

; 開發環境：顯示所有錯誤除 Notice
error_reporting = E_ALL & ~E_NOTICE

; 生產環境：關閉顯示，記錄日誌
display_errors = Off
log_errors = On
error_log = /var/log/php_errors.log

2. 運行時動態設置（無 php.ini 權限時）

<?php
// 腳本頂部
ini_set('error_reporting', E_ALL & ~E_NOTICE);
// 或完全關閉顯示
ini_set('display_errors', '0');
?>

3. .htaccess (Apache)

php_value error_reporting 32759  ; E_ALL & ~E_NOTICE
php_flag display_errors Off

方案三：register_globals 歷史遺留問題

背景： PHP 4.2+ 默認 register_globals = Off，舊代碼直接使用 $var 而非 $_POST['var'] 導致未定義。

錯誤做法： 開啟 register_globals = On（嚴重安全隱患，PHP 5.4+ 已移除）。

正確遷移：

<?php
// 頂部批量導入（不推薦長期使用）
extract($_POST);
extract($_GET);
// 需先 session_start()
extract($_SESSION);
// 推薦：逐個顯式賦值或使用封裝函數
?>

最佳實踐建議

1. 開發環境：error_reporting = E_ALL，強迫自己寫嚴謹代碼
2. 生產環境：display_errors = Off + log_errors = On，用戶不見錯誤，開發者能查日誌
3. 代碼規範：所有外部輸入（$_GET/POST/COOKIE/REQUEST）必須經過 isset()/??/filter_input() 處理
4. 框架層統一：在框架入口/基類控制器封裝 input() 方法，全項目統一調用

快速排查清單

• ☐ 表單字段名與代碼讀取鍵名是否一致（大小寫、下劃線）
• ☐ 是否在 session_start() 前嘗試讀取 $_SESSION
• ☐ AJAX 請求是否正確設置 Content-Type: application/x-www-form-urlencoded
• ☐ 是否混用 $var 與 $_POST['var']（register_globals 遺留）