亂碼根因
- 瀏覽器發送 AJAX 請求預設使用 UTF-8 編碼 (XMLHttpRequest 標準)。
- PHP 預設內部編碼可能為 GBK/GB2312 (舊專案) 或 UTF-8 (現代專案)。
- 資料庫連線編碼、表欄位編碼、HTML meta 標籤、PHP 檔案編碼不一致。
統一編碼策略 (推薦:全棧 UTF-8)
- PHP 檔案:儲存為 UTF-8 無 BOM
- HTML:
<meta charset="UTF-8">
- PHP 入口:
header('Content-Type: application/json; charset=UTF-8');
- 資料庫連線:
SET NAMES utf8mb4 (支援 Emoji)
- 資料表/欄位:
CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
- PHP.ini:
default_charset = "UTF-8"
舊專案 GBK 環境快速修復
<?php
// api.php - 接收 AJAX 請求
// 1. 宣告輸出編碼
header('Content-Type: text/html; charset=GB2312');
// 2. 將接收到的 UTF-8 參數轉為 GBK
if (isset($_POST['content'])) {
$_POST['content'] = iconv('UTF-8', 'GB2312//IGNORE', $_POST['content']);
}
// 3. 業務邏輯...
echo "收到內容: " . $_POST['content'];
?>
// 前端頁面 (GB2312)
<meta http-equiv="Content-Type" content="text/html; charset=gb2312">
<script>
function send() {
var xhr = new XMLHttpRequest();
xhr.open('POST', 'api.php', true);
xhr.setRequestHeader('Content-Type', 'application/x-www-form-urlencoded');
// 關鍵:強制指定發送編碼 (舊瀏覽器需求)
// 現代瀏覽器預設 UTF-8,iconv 在後端轉碼即可
xhr.send('content=' + encodeURIComponent(document.getElementById('input').value));
}
</script>
現代最佳實踐:JSON API + UTF-8
<?php
// api.php - 現代寫法
header('Content-Type: application/json; charset=UTF-8');
$input = json_decode(file_get_contents('php://input'), true);
$content = $input['content'] ?? '';
// 直接使用 UTF-8,無需轉碼
$stmt = $pdo->prepare("INSERT INTO messages (content) VALUES (?)");
$stmt->execute([$content]);
echo json_encode(['success' => true, 'id' => $pdo->lastInsertId()], JSON_UNESCAPED_UNICODE);
?>
// 前端 fetch API (自動 UTF-8)
async function send() {
const res = await fetch('api.php', {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({content: document.getElementById('input').value})
});
const data = await res.json();
console.log(data);
}
常見坑點速查
| 現象 | 可能原因 | 檢查重點 |
| 中文變問號 ??? | 資料庫連線編碼錯誤 | PDO: SET NAMES utf8mb4; mysqli: mysqli_set_charset($link, 'utf8mb4') |
| 存入資料庫正常,讀出亂碼 | PHP 輸出編碼未設定 | header('Content-Type: ... charset=UTF-8') |
| 檔案編碼不一致 | 編輯器儲存為 ANSI/GBK | VS Code/PhpStorm 設定 UTF-8 無 BOM |
| iconv 轉碼丟字 | 目標編碼不支援字符 | 用 //IGNORE 或 //TRANSLIT,或改用 mb_convert_encoding |
| 雙重編碼 | 前端 encodeURIComponent + 後端又轉碼 | 統一由後端解碼,前端勿手動編碼 JSON |
除錯工具
mb_detect_encoding($str, ['UTF-8', 'GBK', 'ASCII']) 檢測編碼
- 瀏覽器 Network 分頁查看 Request/Response Headers 與 Payload
- 資料庫客戶端
SHOW VARIABLES LIKE 'character_set%';