瀏覽器顯示編碼 ≠ 網頁實際編碼 ≠ PHP 內部編碼 ≠ 資料庫編碼 ≠ 檔案儲存編碼。任一環節不一致,即產生亂碼 (、、亂碼字符)。
<?php
// 檔案最頂端,任何輸出之前
header('Content-Type: text/html; charset=UTF-8');
// 或
header('Content-Type: application/json; charset=UTF-8'); // API
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8"> <!-- HTML5 簡寫,等同 http-equiv -->
<title>正確編碼頁面</title>
</head>
舊版 HTML4/XHTML 寫法:<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
find . -name "*.php" -exec iconv -f BIG5 -t UTF-8 {} -o {}.utf8 \;-- 1. 資料庫/資料表/欄位全鏈路 utf8mb4 (支援 Emoji/補充字符)
CREATE DATABASE mydb CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 2. PHP PDO 連線指定字符集
$pdo = new PDO(
'mysql:host=localhost;dbname=mydb;charset=utf8mb4',
'user', 'pass',
[PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
);
-- 或 mysqli
$mysqli->set_charset('utf8mb4');
關鍵:連線字符集 必須與資料表一致,否則中文存入變 ??? 或 。
<?php
// 統一編碼常數
define('APP_CHARSET', 'UTF-8');
// 入口檔統一設定
header('Content-Type: text/html; charset=' . APP_CHARSET);
mb_internal_encoding(APP_CHARSET); // 內部字串處理編碼
mb_http_output(APP_CHARSET); // 輸出編碼
mb_regex_encoding(APP_CHARSET); // 正則編碼
ini_set('default_charset', APP_CHARSET); // PHP 5.6+ 影響 htmlentities 等預設編碼
// 資料庫連線工廠
function createPdo(): PDO {
return new PDO(
"mysql:host={$_ENV['DB_HOST']};dbname={$_ENV['DB_NAME']};charset=" . APP_CHARSET,
$_ENV['DB_USER'], $_ENV['DB_PASS'],
[PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION, PDO::ATTR_EMULATE_PREPARES => false]
);
}
| 現象 | 可能原因 | 解決 |
|---|---|---|
| 菱形問號 | UTF-8 字節序列不完整/被截斷 | 檢查資料庫連線字符集、檔案儲存編碼、mbstring 設定 |
| 方塊問號 | 字體缺少字符 (非編碼問題) | 換支援字符的字體 (Noto Sans CJK 等) |
| 亂碼字符 (絲) | BIG5/GBK 檔案以 UTF-8 讀取 | 統一轉 UTF-8 無 BOM,或正確宣告編碼 |
| JSON 輸出中文變 \uXXXX | json_encode 預設轉義 Unicode | json_encode($data, JSON_UNESCAPED_UNICODE) |
| header() 失效、警告 | header 前有輸出 (空白、BOM、echo) | 檢查檔案開頭、關閉標籤、include 檔案 |
php -i | grep -i charset 確認 PHP 內建預設編碼。Content-Type 是否含 charset=UTF-8。var_dump(mb_detect_encoding($str)) 檢測字串實際編碼。SHOW VARIABLES LIKE 'character_set%'; SHOW CREATE TABLE users; 確認全鏈路一致。「UTF-8 無 BOM,全鏈路一致」是解決 PHP 亂碼的鐵律。建立專案時即配置編輯器、資料庫、PHP、Web Server、前端模板統一 UTF-8,並以 header() 為最高優先級宣告,即可一勞永逸。若遺留專案混雜編碼,建議以 iconv 或 mb_convert_encoding 批次轉碼,再統一入口設定。