萬盛學電腦網

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

AJAX + PHP 中文亂碼徹底解決:編碼統一與 iconv 轉換實戰

亂碼根因

  • 瀏覽器發送 AJAX 請求預設使用 UTF-8 編碼 (XMLHttpRequest 標準)。
  • PHP 預設內部編碼可能為 GBK/GB2312 (舊專案) 或 UTF-8 (現代專案)。
  • 資料庫連線編碼、表欄位編碼、HTML meta 標籤、PHP 檔案編碼不一致。

統一編碼策略 (推薦:全棧 UTF-8)

  1. PHP 檔案:儲存為 UTF-8 無 BOM
  2. HTML:<meta charset="UTF-8">
  3. PHP 入口:header('Content-Type: application/json; charset=UTF-8');
  4. 資料庫連線:SET NAMES utf8mb4 (支援 Emoji)
  5. 資料表/欄位:CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
  6. 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/GBKVS 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%';
copyright © 萬盛學電腦網 all rights reserved