PHP + MySQL 中文亂碼問題完整解決方案總整理

PHP + MySQL 中文亂碼問題完整解決方案總整理

中文亂碼是 PHP 開發最常見的坑，本文系統梳理五大成因與對應解決方案，建立完整的 UTF-8 編碼鏈路。

五大常見成因

1. 資料庫編碼（utf8mb4）與 PHP 網頁編碼不一致
2. 資料表/欄位建立時未指定 utf8mb4 字元集
3. PHP 頁面輸出編碼與資料庫連線編碼不一致
4. PHP 連線 MySQL 未執行 SET NAMES utf8mb4
5. HTML 表單提交頁面與顯示頁面編碼不一致

完整解決方案四步驟

1. 網頁編碼宣告（HTML + PHP）

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">  <!-- HTML5 簡潔寫法 -->
    <!-- 舊版相容 -->
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>

<?php
// PHP 入口檔案最頂端
header("Content-Type: text/html; charset=utf-8");

重要：PHP 檔案本身必須以 UTF-8 無 BOM 格式儲存（編輯器另存新檔選 UTF-8）。

2. 資料庫與資料表編碼設定

-- 建立資料庫指定 utf8mb4
CREATE DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 建立資料表指定 utf8mb4
CREATE TABLE users (
    id INT AUTO_INCREMENT PRIMARY KEY,
    name VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
) 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 而非 utf8：支援 Emoji 與完整 Unicode 字元（utf8 僅支援 BMP 平面）。

3. PHP 連線設定字元集

// mysqli 物件導向
$mysqli = new mysqli('localhost', 'user', 'pass', 'db');
$mysqli->set_charset('utf8mb4'); // 關鍵！

// PDO（推薦）
$pdo = new PDO('mysql:host=localhost;dbname=db;charset=utf8mb4', 'user', 'pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);

// 旧式 mysql_* 函式（已棄用，僅供參考）
mysql_connect('localhost', 'user', 'pass');
mysql_select_db('db');
mysql_query("SET NAMES utf8mb4");

4. 驗證編碼鏈路

// 檢查連線字元集
$mysqli->query("SHOW VARIABLES LIKE 'character_set_%'");
// 應顯示 client, connection, results, database 皆為 utf8mb4

快速排查清單

常見誤區

• 以為 SET NAMES utf8 就夠了 → 必須是 utf8mb4
• 只設定資料庫編碼，忽略資料表/欄位層級
• PHP 檔案用 ANSI/Big5 儲存，但 header 宣告 UTF-8
• 使用已棄用的 mysql_* 函式且未執行 SET NAMES

建立「UTF-8 全鏈路」是根治中文亂碼的唯一正解：檔案編碼 → HTML 輸出 → PHP header → 連線字元集 → 資料庫/資料表/欄位，層層把關。