正確設定頁面字元編碼可避免中文亂碼,確保瀏覽器正確解碼顯示。PHP 提供兩種主要方式:HTTP 標頭 與 HTML meta 標籤。兩者優先級與適用場景不同,需正確理解。
<?php
// 必須在任何輸出 (echo、HTML、空白) 之前呼叫
header('Content-Type: text/html; charset=utf-8');
// 或分開設定 (同等效果)
header('Content-Type: text/html');
header('charset: utf-8');
優點:
注意:必須在 **任何輸出之前** 呼叫,否則會觸發 Cannot modify header information - headers already sent 警告。
<!-- HTML5 簡潔寫法 (推薦) -->
<meta charset="utf-8">
<!-- HTML4/XHTML 相容寫法 -->
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
優點:
缺點:
<?php
// 1. PHP 最早期設定 HTTP 標頭
header('Content-Type: text/html; charset=utf-8');
?>
<!DOCTYPE html>
<html>
<head>
<!-- 2. HTML meta 作為備援 -->
<meta charset="utf-8">
<title>頁面標題</title>
</head>
<body>
內容...
</body>
</html>
| 場景 | 推薦方式 | 說明 |
|---|---|---|
| 一般 HTML 頁面 | header + meta 雙重 | 最保險 |
| API 回傳 JSON | header('Content-Type: application/json; charset=utf-8') | 無 HTML,meta 無效 |
| API 回傳 XML | header('Content-Type: application/xml; charset=utf-8') | XML 宣告 亦需一致 |
| 檔案下載 | header('Content-Type: application/octet-stream') | 通常不涉及字元編碼 |
| 舊專案維護 (GBK/Big5) | header 設定對應編碼 + meta 同步 | 資料庫/檔案編碼須一致 |
<?php
// 基底控制器
class BaseController {
public function __construct() {
// 統一設定編碼
header('Content-Type: text/html; charset=utf-8');
// 或僅設定 charset (保留原 Content-Type)
// header('charset: utf-8');
}
}
// 或者在入口檔案統一設定
// public/index.php
header('Content-Type: text/html; charset=utf-8');
// ... 後續啟動框架
為徹底解決亂碼,需確保 **全鏈路 UTF-8** (或統一目標編碼):
mb_internal_encoding('UTF-8')SET NAMES utf8mb4 / PDO DSN charset=utf8mb4CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ciheader('Content-Type: ...; charset=utf-8')<meta charset="utf-8"><form accept-charset="utf-8">Content-Type 含 charset=utf-8<meta charset> 是否存在且正確var_dump($str) 看長度與內容