PHP 輸出中文亂碼是新手最常遇到的問題。根本原因是瀏覽器預設編碼與頁面實際編碼不一致。本文提供最直接有效的解決方案。
核心解法:一行 header
<?php
// 必須在「任何輸出之前」放在檔案最頂端
header("Content-Type: text/html; charset=UTF-8");
// 後續輸出中文即正常
echo "中文測試:你好世界!";
?>
編碼對應表
| 頁面編碼 | header 設定 |
| UTF-8 (推薦) | header("Content-Type: text/html; charset=UTF-8"); |
| Big5 (繁體中文舊系統) | header("Content-Type: text/html; charset=Big5"); |
| GBK/GB2312 (簡體中文舊系統) | header("Content-Type: text/html; charset=GBK"); |
⚠️ 絕對要注意的陷阱
header() 必須在任何輸出之前!
以下情況都會導致 Cannot modify header information - headers already sent 錯誤:
- HTML 標籤、空白、換行在
<?php 之前
echo, print, var_dump 等輸出函式在 header 之前
- PHP 結束標籤
?> 後有空白行 (建議純 PHP 檔案省略 ?>)
- include/require 的檔案有輸出或 BOM
- 錯誤訊息、警告輸出在 header 之前
檢查清單
- 檔案儲存編碼 = UTF-8 無 BOM (編輯器右下角確認)
header() 在檔案最開頭,前面零輸出
- 資料庫連線設定
SET NAMES utf8mb4
- 資料表/欄位編碼為 utf8mb4
- HTML meta 標籤一致:
<meta charset="UTF-8">
進階:統一管理編碼設定
<?php
// config.php - 專案通用設定
declare(strict_types=1);
// 1. 設定內部編碼
mb_internal_encoding('UTF-8');
mb_http_output('UTF-8');
mb_regex_encoding('UTF-8');
// 2. 輸出 header (若非 CLI 模式)
if (PHP_SAPI !== 'cli') {
header('Content-Type: text/html; charset=UTF-8');
}
// 3. 資料庫連線統一設定 charset
// PDO: new PDO("mysql:host=...;charset=utf8mb4", ...)
// mysqli: $mysqli->set_charset('utf8mb4');
?>
常見誤區
- ❌ 以為
<meta charset="UTF-8"> 就夠了 → 瀏覽器優先看 HTTP 標頭
- ❌ 用
ob_start() 包起來就能隨便輸出 → 只是緩衝,header 仍需在實際輸出前
- ❌ 只有部分頁面加 header → 必須每個輸出頁面都加,或用共用設定檔
copyright ©
萬盛學電腦網 all rights reserved