萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

MySQL 與網頁亂碼徹底解決:UTF-8 全鏈路一致性設定指南 (含 utf8mb4)

亂碼根本原因:編碼鏈路任一環節不一致


瀏覽器 ↔ HTTP Headers ↔ HTML Meta ↔ PHP 內部處理 ↔ MySQL 連線 ↔ 資料表/欄位定義 ↔ 儲存引擎
      ↑                ↑            ↑              ↑              ↑                ↑
   全部必須統一為 UTF-8 (推薦 utf8mb4)

五大關鍵檢查點 (逐一驗證)

1. 資料庫/資料表/欄位字元集 = 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 位元組字元。

2. PHP 連線建立時設定字元集

<?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` 三個會話變數。

3. PHP 輸出 HTTP Header 宣告 UTF-8

<?php
// 檔案最開頭,任何輸出前
header('Content-Type: text/html; charset=utf-8');
// 或
header('Content-Type: application/json; charset=utf-8'); // API

或在 `php.ini` 設定預設:

default_charset = "UTF-8"

4. HTML Meta 標籤宣告 (第二道防線)

<!DOCTYPE html>
<html lang="zh-Hant">
<head>
    <meta charset="UTF-8">
    <!-- 其它 meta -->
</head>

HTML5 簡寫 `` 等同於舊式 ``。

5. PHP 原始檔案編碼 = UTF-8 (無 BOM)

  • 編輯器 (VS Code/PhpStorm/Notepad++) 右下角確認 **UTF-8** (非 UTF-8 with BOM)
  • BOM 會導致 `header()` 失效、Session 啟動失敗、XML 解析錯誤

完整驗證清單

#檢查項目驗證指令/方法預期結果
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
5HTTP 回應標頭瀏覽器 DevTools Network → Response Headers`Content-Type: text/html; charset=utf-8`
6HTML MetaView Source 搜尋 `charset```
7PHP 檔案編碼編輯器狀態列 / `file -bi your.php`text/x-php; charset=utf-8

常見情境排查

情境 A:資料庫存入正常,讀出顯示 `???` 或亂碼

→ 連線字元集未設定。執行 `SET NAMES utf8mb4` 或 PDO DSN 加 `charset=utf8mb4`。

情境 B:資料庫存入即亂碼 (如 `游进`)

→ 連線字元集正確,但**資料表/欄位字元集錯誤** (如 latin1)。需 `ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4`。

情境 C:瀏覽器顯示亂碼,但 View Source 正常

→ HTTP Header 無 charset 或錯誤。加 `header('Content-Type: ... charset=utf-8')` 或修正 Nginx/Apache 設定。

情境 D:Emoji 😀 存入變 `????` 或截斷

→ 字元集為 `utf8` (utf8mb3) 非 `utf8mb4`。全鏈路升級 utf8mb4。

情境 E:PHP 內部字串操作亂碼 (strlen、substr 截斷中文)

→ 使用 `mb_strlen`、`mb_substr`、`mb_*` 系列函式,並設定 `mb_internal_encoding('UTF-8')`。

Nginx / Apache 伺服器層面設定


# 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 點,即可徹底杜絕亂碼困擾。

copyright © 萬盛學電腦網 all rights reserved