PHP 網頁亂碼排查實戰：從 Apache 到 php.ini 的完整鏈路

問題現場

• XAMPP 環境，頁面顯示亂碼
• Apache 配置、PHP 配置檢查無誤
• 頁面 meta 標籤宣告 UTF-8，但瀏覽器識別為 GBK

排查鏈路

第一層：HTTP 響應頭

# 瀏覽器開發者工具 Network 標籤查看 Response Headers
Content-Type: text/html; charset=gbk  ← 關鍵線索！

HTTP 頭優先級高於 HTML meta 標籤，瀏覽器按此編碼解析。

第二層：phpinfo() 定位來源

<?php phpinfo(); ?>
# 搜尋 "default_charset"
# 發現：default_charset = "gbk"  ← 禍首！

第三層：修正 php.ini

; 修改前
default_charset = "gbk"

; 修改後
default_charset = "UTF-8"
; 或註釋掉，讓頁面自行控制
; default_charset = "UTF-8"

第四層：重啟驗證

# 重啟 Apache
sudo /etc/init.d/apache2 restart
# 或 XAMPP 控制面板 Restart

編碼優先級鏈路（高→低）

1. PHP header()：header("Content-Type: text/html; charset=UTF-8");（代碼層最高）
2. php.ini default_charset：PHP 內建預設
3. Apache AddDefaultCharset：AddDefaultCharset UTF-8 或 Off
4. HTML meta 標籤：<meta charset="UTF-8">
5. 瀏覽器自動偵測：最後防線

完整配置清單

常見避坑指南

• BOM 導致 header 無效：UTF-8 with BOM 會在輸出最前面輸出 3 位元組，導致 header() 失敗。編輯器選「UTF-8 無 BOM」
• 虛擬主機無法改 php.ini：用 .user.ini（PHP 5.3+）或 ini_set('default_charset', 'UTF-8') 在代碼最頂部
• Apache 全域配置覆蓋：共享主機常見，用 .htaccess 加 AddDefaultCharset UTF-8 覆蓋
• 資料庫雙重編碼：資料存 latin1，連線 utf8，讀出再轉碼 → 亂碼。統一 utf8mb4 全鏈路

一鍵診斷腳本

<?php
// encoding_diag.php - 放入專案根目錄訪問
header("Content-Type: text/plain; charset=UTF-8");

echo "=== PHP 編碼診斷 ===\n";
echo "default_charset: " . ini_get('default_charset') . "\n";
echo "mbstring.internal_encoding: " . ini_get('mbstring.internal_encoding') . "\n";
echo "mbstring.http_output: " . ini_get('mbstring.http_output') . "\n";
echo "iconv.internal_encoding: " . ini_get('iconv.internal_encoding') . "\n\n";

echo "=== HTTP 響應頭 ===\n";
echo "Content-Type: " . header_get('Content-Type') . "\n\n";

echo "=== 超全域變數 ===\n";
echo "_SERVER['HTTP_ACCEPT_CHARSET']: " . ($_SERVER['HTTP_ACCEPT_CHARSET'] ?? '未設定') . "\n";
echo "_SERVER['CONTENT_TYPE']: " . ($_SERVER['CONTENT_TYPE'] ?? '未設定') . "\n\n";

echo "=== 測試輸出 ===\n";
echo "中文測試：測試編碼正常\n";
echo "Emoji測試：😀🎉🚀\n";
?>

總結

亂碼本質是**編碼宣告與實際內容不一致**。排查核心：**看 HTTP 響應頭 → 查 php.ini default_charset → 檢查檔案編碼 → 確認資料庫連線編碼**。統一全鏈路 UTF-8（推薦 utf8mb4），在入口文件強制 header() 宣告，是徹底解決之道。