PHP "Undefined index" 提示解決方案總結：五種處理方法與最佳實踐

問題本質

PHP 預設對未定義陣列鍵或變數發出 Notice 級別提示，非致命錯誤。生產環境通常關閉顯示，但開發階段需妥善處理避免邏輯漏洞。

五種解決方案

1. 修改 php.ini 錯誤報告級別（全域）

; 開發環境建議
error_reporting = E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED

; 生產環境
error_reporting = E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED
display_errors = Off
log_errors = On

修改後需重啟 Web 伺服器生效。

2. 變數預先初始化

$act = isset($_POST['action']) ? $_POST['action'] : '';

3. 判斷函數檢查

if (isset($_POST['action'])) { $act = $_POST['action']; }
if (!empty($_POST['action'])) { $act = $_POST['action']; }

4. 抑制運算子 @（不推薦常規使用）

$username = @$_POST['username'];
if (@$_GET['action'] == 'save') { ... }

僅隱藏提示，不解決邏輯問題，除錯困難。

5. 封裝存取函數（推薦）

function _get($key, $default = null) {
    return isset($_GET[$key]) ? $_GET[$key] : $default;
}

function _post($key, $default = null) {
    return isset($_POST[$key]) ? $_POST[$key] : $default;
}

// 使用
$act = _post('action');
$id = _get('id', 0);

最佳實踐建議

1. 開發環境：開啟完整錯誤報告，使用方案 5 封裝存取
2. 生產環境：關閉顯示、開啟日誌，配合方案 5
3. 避免：長期依賴 @ 抑制，掩蓋潛在 Bug

相關提示類型

• Undefined index：陣列鍵不存在（$_GET、$_POST、$_SESSION 等）
• Undefined variable：變數未定義即使用
• Undefined offset：數值索引陣列越界