亂碼是 PHP 初學者最常遇到的棘手問題。本質上,亂碼源於「編碼不一致」:瀏覽器、HTML 頁面、PHP 檔案、資料庫、資料庫連線、資料表、欄位——任一環節編碼不匹配,即會導致字元錯誤顯示。本文提供系統性排查清單。
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta charset="utf-8">
此編碼必須與資料庫、連線編碼完全一致(建議統一使用 utf-8 或 utf8mb4)。
編輯器(VS Code、PhpStorm、EditPlus、Notepad++ 等)儲存檔案時,必須選擇「UTF-8 無 BOM」編碼。BOM 會導致 HTTP 標頭輸出錯誤、Session 啟動失敗等問題。這是最容易被忽略的環節。
在 phpMyAdmin 或 SQL 指令中設定:
CREATE DATABASE mydb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE TABLE users (
id INT PRIMARY KEY AUTO_INCREMENT,
name VARCHAR(50)
) DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;
建表時若未指定欄位編碼,將繼承資料表編碼。若需單獨指定:
ALTER TABLE users MODIFY name VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
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")。
本地測試正常、上線後亂碼,常見原因:
Content-Type: text/html; charset=utf-8。SHOW VARIABLES LIKE 'character_set%'; 確認連線/資料庫/結果集編碼均為 utf8mb4。var_dump(mb_detect_encoding($string)) 檢測變數實際編碼。全鏈路 UTF-8(或 utf8mb4)一致性:檔案儲存、HTML 宣告、資料庫、資料表、欄位、連線字元集——六位一體,缺一不可。
技術不難,關鍵在「細心」。建立專案初始化 Checklist,每次部署逐項核對,即可徹底告別亂碼困擾。