PHP 設定 UTF-8 標頭與錯誤報告等級完整指南

PHP 設定 UTF-8 標頭與錯誤報告等級完整指南

在開發 PHP 應用時，正確設定字元編碼與錯誤報告等級是基礎且關鍵的步驟。本文整理 header() 設定 UTF-8 的最佳實務，並詳細說明 error_reporting() 各等級常數與組合技巧。

一、設定 UTF-8 回應標頭

<?php
// 必須在任何輸出之前呼叫
header('Content-Type: text/html; charset=utf-8');
?>

此行等同於 HTML 中的 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">，但 HTTP 標頭優先級更高，能確保瀏覽器正確解碼，避免中文亂碼。

二、error_reporting() 詳細等級表

error_reporting() 控制執行時期回報的錯誤類型。參數為位元遮罩，可用 | 或 OR 組合。

三、常見設定範例

開發環境：回報所有錯誤

error_reporting(E_ALL);
ini_set('display_errors', '1'); // 直接顯示於頁面

生產環境：隱藏錯誤、記錄日誌

error_reporting(E_ALL & ~E_NOTICE & ~E_STRICT & ~E_DEPRECATED);
ini_set('display_errors', '0');
ini_set('log_errors', '1');
ini_set('error_log', '/var/log/php/error.log');

暫時關閉錯誤報告（如第三方庫產生大量 Notice）

$oldLevel = error_reporting(0);
// 呼叫第三方程式碼...
error_reporting($oldLevel); // 還原

四、最佳實務建議

1. 統一編碼：PHP 檔案儲存為 UTF-8 無 BOM，資料庫連線設定 SET NAMES utf8mb4，HTML 標頭同步宣告。
2. 分環境設定：利用 .env 或設定檔區分開發/測試/生產的 error_reporting 與 display_errors。
3. 自訂錯誤處理器：生產環境建議用 set_error_handler() 統一格式化記錄，避免敏感資訊外洩。
4. 嚴格模式：新專案建議啟用 declare(strict_types=1); 搭配 E_ALL，盡早發現型別不符問題。

正確設定字元編碼與錯誤報告，能大幅減少亂碼與難以重現的 Bug，是 PHP 專案上線前的必修課。