PHP.ini 錯誤顯示與日誌配置最佳實踐：開發、測試、生產環境差異化設定

正確配置 PHP 錯誤報告機制，能在開發期快速定位問題，在生產期避免敏感資訊洩露並保留審計線索。本文梳理 php.ini 核心指令與環境差異化建議。

核心指令速查

錯誤級別常用常數

E_ERROR             // 致命運行錯誤
E_WARNING           // 運行警告（非致命）
E_PARSE             // 編譯時語法解析錯誤
E_NOTICE            // 運行時通知（如未定義變數）
E_DEPRECATED        // 棄用功能警告
E_STRICT            // 編碼標準建議
E_ALL               // 所有錯誤（除 E_STRICT 外，PHP 5.4 前）

運行時動態調整

<?php
// 僅影響當前腳本
error_reporting(E_ALL & ~E_NOTICE);  // 隱藏 Notice
ini_set('display_errors', '1');      // 開啟顯示（若 php.ini 允許覆寫）

// 自定義錯誤處理器（生產環境推薦）
set_error_handler(function($severity, $message, $file, $line) {
    if (!(error_reporting() & $severity)) return false;  // 不在報告級別內
    error_log("[$severity] $message in $file:$line");
    // 生產環境可發送郵件/推送至 Sentry 等
    return true;  // 不執行內建處理器
});

環境差異化配置策略

• 開發環境：display_errors=On、error_reporting=E_ALL、html_errors=On，即時在瀏覽器看到完整堆疊。
• 測試/Staging：關閉顯示、開啟日誌、級別 E_ALL，模擬生產行為但保留完整日誌。
• 生產環境：display_errors=Off、log_errors=On、error_log 指向專用文件/系統日誌、html_errors=Off、考慮 ignore_repeated_errors=On 減少日誌噪音。

日誌輪轉與監控建議

• 使用 logrotate 定期切割 error_log，避免磁碟佔滿。
• 接入 ELK/EFK、Loki、Datadog 等日誌聚合平台，設置告警規則（如 5 分鐘內 Fatal > 10 則觸發通知）。
• PHP-FPM 錯誤日誌（php-fpm.conf 中 error_log）與 PHP 執行時錯誤日誌分離管理。