瀏覽器 ↔ HTTP Headers ↔ HTML Meta ↔ PHP 內部處理 ↔ MySQL 連線 ↔ 資料表/欄位定義 ↔ 儲存引擎
↑ ↑ ↑ ↑ ↑ ↑
全部必須統一為 UTF-8 (推薦 utf8mb4)
-- 建庫指定
CREATE DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 建表指定
CREATE TABLE users (
id INT AUTO_INCREMENT PRIMARY KEY,
name VARCHAR(50) NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 修改既有資料庫/資料表
ALTER DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE users MODIFY name VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
為什麼 utf8mb4? MySQL 老版 `utf8` 實為 `utf8mb3`,僅支援 BMP 平面 (3 位元組),無法儲存 Emoji (😀)、生僻字。`utf8mb4` 完整支援 Unicode 4 位元組字元。
<?php
// PDO (推薦)
$dsn = "mysql:host=127.0.0.1;dbname=mydb;charset=utf8mb4";
$pdo = new PDO($dsn, $user, $pass, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4 COLLATE utf8mb4_unicode_ci",
]);
// mysqli (程序式)
$mysqli = mysqli_connect('127.0.0.1', $user, $pass, 'mydb');
mysqli_set_charset($mysqli, 'utf8mb4'); // 必須在查詢前呼叫
// mysqli (OO)
$mysqli = new mysqli('127.0.0.1', $user, $pass, 'mydb');
$mysqli->set_charset('utf8mb4');
注意:`SET NAMES utf8mb4` 等同於同時設定 `character_set_client`、`character_set_connection`、`character_set_results` 三個會話變數。
<?php
// 檔案最開頭,任何輸出前
header('Content-Type: text/html; charset=utf-8');
// 或
header('Content-Type: application/json; charset=utf-8'); // API
或在 `php.ini` 設定預設:
default_charset = "UTF-8"
<!DOCTYPE html>
<html lang="zh-Hant">
<head>
<meta charset="UTF-8">
<!-- 其它 meta -->
</head>
HTML5 簡寫 `` 等同於舊式 ``。
| # | 檢查項目 | 驗證指令/方法 | 預期結果 |
|---|---|---|---|
| 1 | 資料庫預設字元集 | `SHOW VARIABLES LIKE 'character_set_database';` | utf8mb4 |
| 2 | 資料表字元集 | `SHOW CREATE TABLE users;` | DEFAULT CHARSET=utf8mb4 |
| 3 | 欄位字元集 | `SHOW FULL COLUMNS FROM users;` | Collation utf8mb4_unicode_ci |
| 4 | 連線字元集 | `SHOW VARIABLES LIKE 'character_set_%';` (連線後) | client/connection/results 皆 utf8mb4 |
| 5 | HTTP 回應標頭 | 瀏覽器 DevTools Network → Response Headers | `Content-Type: text/html; charset=utf-8` |
| 6 | HTML Meta | View Source 搜尋 `charset` | `` |
| 7 | PHP 檔案編碼 | 編輯器狀態列 / `file -bi your.php` | text/x-php; charset=utf-8 |
→ 連線字元集未設定。執行 `SET NAMES utf8mb4` 或 PDO DSN 加 `charset=utf8mb4`。
→ 連線字元集正確,但**資料表/欄位字元集錯誤** (如 latin1)。需 `ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4`。
→ HTTP Header 無 charset 或錯誤。加 `header('Content-Type: ... charset=utf-8')` 或修正 Nginx/Apache 設定。
→ 字元集為 `utf8` (utf8mb3) 非 `utf8mb4`。全鏈路升級 utf8mb4。
→ 使用 `mb_strlen`、`mb_substr`、`mb_*` 系列函式,並設定 `mb_internal_encoding('UTF-8')`。
# Nginx
server {
charset utf-8; # 強制回應標頭 charset
# 或更完整
add_header Content-Type "text/html; charset=utf-8" always;
}
# Apache (.htaccess 或 httpd.conf)
AddDefaultCharset UTF-8
AddCharset UTF-8 .php .html .css .js
亂碼問題 99% 來自「編碼鏈路不一致」。建立 **UTF-8 (utf8mb4) 全鏈路標準**,從資料庫建立、連線參數、PHP 輸出、HTML Meta、檔案編碼、Web Server 設定逐項落實,並建立自動化檢查腳本驗證上述 7 點,即可徹底杜絕亂碼困擾。