萬盛學電腦網

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

PHP MySQL 中文亂碼解決方案:編碼一致性完整指南

中文資料無法正確寫入/讀出 MySQL,99% 是編碼不一致造成。本文系統說明「資料庫、連線、網頁、PHP 內部」四層編碼必須一致的原則,並提供完整解決方案。

核心原則:四層編碼必須一致

  1. 資料庫/資料表/欄位編碼 — CHARSET=utf8mb4
  2. 連線編碼 — SET NAMES utf8mb4
  3. HTML 輸出編碼 — <meta charset="utf-8">
  4. PHP 內部/檔案編碼 — 檔案儲存為 UTF-8 無 BOM

方案一:資料庫建立時指定 utf8mb4(推薦)

-- 建立資料庫
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 連線時設定字元集

PDO(推薦)

<?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

mysqli 程式風格

<?php
$mysqli = new mysqli('127.0.0.1', 'user', 'pass', 'my_db');
$mysqli->set_charset('utf8mb4'); // 必須在查詢前呼叫

mysqli 物件導向(舊式 mysql_* 已移除)

<?php
// mysql_* 函數在 PHP 7.0 移除,請勿使用
// 舊代碼遷移範例:
$conn = mysqli_connect('127.0.0.1', 'user', 'pass', 'my_db');
mysqli_set_charset($conn, 'utf8mb4');

方案三:HTML 頁面宣告編碼

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

方案四:PHP 檔案本身儲存為 UTF-8 無 BOM

  • VS Code:右下角編碼選「UTF-8」(非 UTF-8 with BOM)
  • PhpStorm:File → File Encoding → UTF-8
  • Notepad++:編碼 → 轉為 UTF-8 編碼

常見問題排查清單

現象可能原因檢查項目
存入資料庫變 ??? 或 亂碼連線編碼未設定確認執行 SET NAMES utf8mb4 或 DSN 含 charset
讀出顯示 或 亂碼HTML 輸出編碼錯誤確認 <meta charset="utf-8">、HTTP Header Content-Type: text/html; charset=utf-8
Emoji 變 ????資料庫/欄位非 utf8mb4ALTER 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;

補充:iconv 轉碼應急方案

<?php
// 僅作為臨時相容,不建議長期依賴
$str = iconv('GBK', 'UTF-8//IGNORE', $legacy_str);
$str = iconv('BIG5', 'UTF-8//IGNORE', $legacy_str);

// //IGNORE 會忽略無法轉換的字元,避免報錯中斷

建立新專案時,全端統一使用 UTF-8 (utf8mb4),可從根本避免中文亂碼問題。

copyright © 萬盛學電腦網 all rights reserved