編碼鏈路圖解
[編輯器/IDE 儲存編碼] → [PHP 源碼文件編碼] → [PHP 內部處理] → [HTTP 響應 Header] → [瀏覽器解碼]
↓ ↓ ↓ ↓ ↓
UTF-8 (推薦) UTF-8 無 BOM UTF-8 Content-Type: charset=UTF-8 自動/手動選擇
↑ ↑ ↑ ↑ ↑
.env/配置檔 include/require 資料庫連線編碼 header() meta charset
七大亂碼根因與解決
1. HTML 頁面編碼宣告缺失或錯誤
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8"> <!-- HTML5 簡潔寫法,必須在 <head> 最前 -->
<!-- 舊寫法相容 -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
2. PHP 檔案儲存編碼不一致
- 現象:代碼裡的中文變成亂碼或問號
- 解決:IDE (VS Code/PhpStorm/EditPlus) 統一設定 UTF-8 無 BOM 儲存
- 檢查:
file -bi your.php 應顯示 text/x-php; charset=utf-8
3. 資料庫/表/欄位編碼不一致
-- 建庫建表指定 utf8mb4 (支援 emoji)
CREATE DATABASE myapp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE TABLE users (
name VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;
-- 檢查現有編碼
SHOW VARIABLES LIKE 'character_set%';
SHOW CREATE TABLE users;
4. PHP 連線未設定字符集
<?php
// PDO (推薦)
$pdo = new PDO(
'mysql:host=localhost;dbname=myapp;charset=utf8mb4',
'user', 'pass',
[PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
);
// mysqli
$mysqli = new mysqli('localhost', 'user', 'pass', 'myapp');
$mysqli->set_charset('utf8mb4'); // 必須在查詢前呼叫
// 舊 mysql_* (已移除) 時代遺留寫法
// mysql_query("SET NAMES utf8mb4");
5. HTTP 響應 Header 缺少 charset
<?php
// 必須在任何輸出前
header('Content-Type: text/html; charset=UTF-8');
// 或 JSON API
header('Content-Type: application/json; charset=UTF-8');
6. 資料匯入/匯出編碼轉換錯誤
<?php
// 匯出 CSV 給 Excel (需 UTF-8 with BOM 或 GBK)
$bom = "\xEF\xBB\xBF"; // UTF-8 BOM
$csv = $bom . implode(',', $headers) . "\n";
foreach ($rows as $row) {
$csv .= implode(',', array_map(fn($v) => '"' . str_replace('"', '""', $v) . '"', $row)) . "\n";
}
// 或轉 GBK
$csv = iconv('UTF-8', 'GBK//IGNORE', $csv);
7. 前端表單提交編碼
<form accept-charset="UTF-8" ...>
除錯檢查清單
- 瀏覽器 Network 面板:檢查 Response Headers `Content-Type` 是否含 `charset=UTF-8`
- 瀏覽器開發者工具:Console 執行 `document.characterSet` 確認解碼編碼
- 資料庫客戶端:`SELECT HEX(column) FROM table` 檢查實際儲存位元組
- PHP 端:`var_dump(bin2hex($str))` 查看字串實際位元組
- 檔案編碼:`xxd your.php | head` 檢查 BOM (EF BB BF)
現代最佳實踐:全鏈路 UTF-8
- 源碼、資料庫、連線、HTTP、頁面、JS/CSS 檔案 全鏈路 UTF-8 (utf8mb4)
- 拒絕 GB2321/Big5/GBK 等舊編碼,除非對接 legacy 系統
- 使用
declare(encoding='UTF-8'); 在 PHP 檔案頂部 (PHP 5.3+)
- Composer 專案:`composer.json` 確保 `
"config": {"optimize-autoloader": true}` 不影響編碼