中文資料無法正確寫入/讀出 MySQL,99% 是編碼不一致造成。本文系統說明「資料庫、連線、網頁、PHP 內部」四層編碼必須一致的原則,並提供完整解決方案。
CHARSET=utf8mb4SET NAMES utf8mb4<meta charset="utf-8">-- 建立資料庫
CREATE DATABASE `my_db` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 建立資料表
CREATE TABLE `articles` (
`id` INT UNSIGNED AUTO_INCREMENT PRIMARY KEY,
`title` VARCHAR(200) NOT NULL,
`content` TEXT NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
為何用 utf8mb4? MySQL 的 utf8 實為 utf8mb3,僅支援 3 位元組字元(基本多文種平面),無法儲存 Emoji、生僻字、部分擴展漢字。utf8mb4 完整支援 Unicode 4 位元組字元。
<?php
$dsn = 'mysql:host=127.0.0.1;dbname=my_db;charset=utf8mb4';
$pdo = new PDO($dsn, 'user', 'pass', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_EMULATE_PREPARES => false,
]);
// DSN 中的 charset=utf8mb4 會自動執行 SET NAMES utf8mb4
<?php
$mysqli = new mysqli('127.0.0.1', 'user', 'pass', 'my_db');
$mysqli->set_charset('utf8mb4'); // 必須在查詢前呼叫
<?php
// mysql_* 函數在 PHP 7.0 移除,請勿使用
// 舊代碼遷移範例:
$conn = mysqli_connect('127.0.0.1', 'user', 'pass', 'my_db');
mysqli_set_charset($conn, 'utf8mb4');
<!DOCTYPE html>
<html lang="zh-TW">
<head>
<meta charset="utf-8"> <!-- HTML5 簡潔寫法 -->
<!-- 舊寫法相容:<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> -->
</head>
File → File Encoding → UTF-8編碼 → 轉為 UTF-8 編碼| 現象 | 可能原因 | 檢查項目 |
|---|---|---|
| 存入資料庫變 ??? 或 亂碼 | 連線編碼未設定 | 確認執行 SET NAMES utf8mb4 或 DSN 含 charset |
| 讀出顯示 或 亂碼 | HTML 輸出編碼錯誤 | 確認 <meta charset="utf-8">、HTTP Header Content-Type: text/html; charset=utf-8 |
| Emoji 變 ???? | 資料庫/欄位非 utf8mb4 | ALTER TABLE t CONVERT TO CHARACTER SET utf8mb4 |
| 中文截取斷碼 | 用 substr 而非 mb_substr | 啟用 mbstring,使用 mb_substr($str, 0, 10, 'UTF-8') |
| JSON 輸出中文成 \uXXXX | 預設行為 | json_encode($data, JSON_UNESCAPED_UNICODE) |
-- 1. 資料庫層級
ALTER DATABASE `my_db` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
-- 2. 每個資料表
ALTER TABLE `table_name` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 3. 每個文字欄位(若 CONVERT 不完全)
ALTER TABLE `table_name` CHANGE `col` `col` VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL;
<?php
// 僅作為臨時相容,不建議長期依賴
$str = iconv('GBK', 'UTF-8//IGNORE', $legacy_str);
$str = iconv('BIG5', 'UTF-8//IGNORE', $legacy_str);
// //IGNORE 會忽略無法轉換的字元,避免報錯中斷
建立新專案時,全端統一使用 UTF-8 (utf8mb4),可從根本避免中文亂碼問題。