萬盛學電腦網

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

PHP 亂碼問題完整排查指南:從編碼到資料庫的全鏈路解決方案

前言

亂碼是 PHP 初學者最常遇到的棘手問題。本質上,亂碼源於「編碼不一致」:瀏覽器、HTML 頁面、PHP 檔案、資料庫、資料庫連線、資料表、欄位——任一環節編碼不匹配,即會導致字元錯誤顯示。本文提供系統性排查清單。

七大關鍵檢查點

1. HTML 頁面宣告編碼

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

<meta charset="utf-8">

此編碼必須與資料庫、連線編碼完全一致(建議統一使用 utf-8 或 utf8mb4)。

2. PHP 檔案儲存編碼

編輯器(VS Code、PhpStorm、EditPlus、Notepad++ 等)儲存檔案時,必須選擇「UTF-8 無 BOM」編碼。BOM 會導致 HTTP 標頭輸出錯誤、Session 啟動失敗等問題。這是最容易被忽略的環節。

3. 資料庫預設編碼

在 phpMyAdmin 或 SQL 指令中設定:

CREATE DATABASE mydb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

4. 資料表編碼

CREATE TABLE users (
    id INT PRIMARY KEY AUTO_INCREMENT,
    name VARCHAR(50)
) DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

5. 欄位編碼

建表時若未指定欄位編碼,將繼承資料表編碼。若需單獨指定:

ALTER TABLE users MODIFY name VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

6. 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->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

舊式 mysql_* 函數已棄用,請勿使用 mysql_query("SET NAMES utf8")。

7. 資料匯入/匯出編碼一致性

本地測試正常、上線後亂碼,常見原因:

  • 匯出 SQL 檔時未指定正確編碼(phpMyAdmin 匯出選項勾選「字元集」)。
  • 匯入目標資料庫編碼與來源不符。
  • SQL 檔案本身儲存編碼錯誤(用編輯器開啟確認)。

快速驗證步驟

  1. 瀏覽器開發者工具 → Network → Response Headers → 確認 Content-Type: text/html; charset=utf-8。
  2. 資料庫客戶端執行 SHOW VARIABLES LIKE 'character_set%'; 確認連線/資料庫/結果集編碼均為 utf8mb4。
  3. PHP 中 var_dump(mb_detect_encoding($string)) 檢測變數實際編碼。

核心原則

全鏈路 UTF-8(或 utf8mb4)一致性:檔案儲存、HTML 宣告、資料庫、資料表、欄位、連線字元集——六位一體,缺一不可。

技術不難,關鍵在「細心」。建立專案初始化 Checklist,每次部署逐項核對,即可徹底告別亂碼困擾。

copyright © 萬盛學電腦網 all rights reserved