數據庫默認編碼 → 表編碼 → 字段編碼 → 連接編碼 → PHP 文件編碼 → 頁面輸出編碼 → 瀏覽器解碼
↑ ↑ ↑ ↑ ↑ ↑ ↑
必須一致 必須一致 必須一致 必須一致 必須一致 必須一致 必須一致
-- 創建數據庫
CREATE DATABASE mydb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 創建表 (指定表級編碼)
CREATE TABLE useradmin (
id INT AUTO_INCREMENT PRIMARY KEY,
username VARCHAR(20) NOT NULL,
userpass VARCHAR(40) NOT NULL,
logins INT DEFAULT 0,
logintime TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
mid CHAR(1) DEFAULT '0'
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
-- 修改現有表/字段
ALTER TABLE useradmin CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE useradmin MODIFY username VARCHAR(20) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
<?php
// mysqli 面向對象
$mysqli = new mysqli('localhost', 'user', 'pass', 'mydb');
$mysqli->set_charset('utf8mb4'); // ★★★ 關鍵一行 ★★★
// mysqli 過程式
$link = mysqli_connect('localhost', 'user', 'pass', 'mydb');
mysqli_set_charset($link, 'utf8mb4');
// PDO (推薦)
$pdo = new PDO('mysql:host=localhost;dbname=mydb;charset=utf8mb4', 'user', 'pass', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_EMULATE_PREPARES => false,
]);
// 老式 mysql_* (已移除,僅參考)
mysql_connect(...);
mysql_query("SET NAMES 'utf8mb4'"); // 相當於 SET character_set_client/connection/results
<?php
// PHP 頭部 (必須在任何輸出前)
header('Content-Type: text/html; charset=utf-8');
?>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8"> <!-- HTML5 簡寫 -->
<!-- 兼容舊瀏覽器 -->
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
...
<?php
// 1. 連接設置為 UTF-8
$mysqli = new mysqli('localhost', 'user', 'pass', 'mydb');
$mysqli->set_charset('utf8mb4');
// 2. 頁面聲明 GBK
header('Content-Type: text/html; charset=gbk');
// 或
// 3. 查詢數據 (從 UTF-8 數據庫讀取)
$result = $mysqli->query('SELECT * FROM useradmin');
// 4. 輸出前轉碼
while ($row = $result->fetch_assoc()) {
// 數據庫 UTF-8 → 頁面 GBK
$name = iconv('UTF-8', 'GBK//IGNORE', $row['username']);
echo $name;
}
// 5. 寫入前轉碼 (頁面 GBK → 數據庫 UTF-8)
$input = $_POST['username']; // GBK
$name = iconv('GBK', 'UTF-8//IGNORE', $input);
$mysqli->query("INSERT INTO useradmin (username) VALUES ('{$mysqli->real_escape_string($name)}')");
<?php
// API 介面統一輸出 UTF-8 JSON
header('Content-Type: application/json; charset=utf-8');
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
// 前端 JS 發送時默認 UTF-8,無需額外處理
// jQuery: $.ajax({url, data: {name: '中文'}}) 自動 UTF-8 編碼
| 誤區 | 正確做法 |
|---|---|
| 以為 `SET NAMES utf8` 就夠了 | 必須配合數據庫/表/字段編碼、PHP文件編碼、頁面輸出編碼 |
| 用 `utf8` 而非 `utf8mb4` | `utf8` 只支持 BMP (3字節),無法存 Emoji/生僻字,**必須用 utf8mb4** |
| 只設置數據庫默認編碼 | 表、字段可單獨指定編碼,**必須顯式指定表/字段為 utf8mb4** |
| 忽略 PHP 文件 BOM | **嚴禁 BOM**,導致輸出異常、header 失效、Session 啟動失敗 |
中文亂碼 = **編碼不一致**。解決核心:**全鏈路 utf8mb4**。新項目:數據庫/表/字段 utf8mb4 + 連接 `set_charset('utf8mb4')` + PHP 文件 UTF-8 無 BOM + 頁面 ``。老項目 GBK 共存:連接層轉碼 `iconv`。PDO + `charset=utf8mb4` 是現代最省心方案。