萬盛學電腦網

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

PHP 亂碼問題根因分析與解決方案:編碼鏈路完整排查指南

編碼鏈路圖解


[編輯器/IDE 儲存編碼] → [PHP 源碼文件編碼] → [PHP 內部處理] → [HTTP 響應 Header] → [瀏覽器解碼]
       ↓                         ↓                      ↓                    ↓                  ↓
   UTF-8 (推薦)              UTF-8 無 BOM          UTF-8              Content-Type: charset=UTF-8   自動/手動選擇
       ↑                         ↑                      ↑                    ↑                  ↑
   .env/配置檔              include/require       資料庫連線編碼         header()           meta charset

七大亂碼根因與解決

1. HTML 頁面編碼宣告缺失或錯誤

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8"> <!-- HTML5 簡潔寫法,必須在 <head> 最前 -->
    <!-- 舊寫法相容 -->
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>

2. PHP 檔案儲存編碼不一致

  • 現象:代碼裡的中文變成亂碼或問號
  • 解決:IDE (VS Code/PhpStorm/EditPlus) 統一設定 UTF-8 無 BOM 儲存
  • 檢查:file -bi your.php 應顯示 text/x-php; charset=utf-8

3. 資料庫/表/欄位編碼不一致

-- 建庫建表指定 utf8mb4 (支援 emoji)
CREATE DATABASE myapp CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE TABLE users (
    name VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

-- 檢查現有編碼
SHOW VARIABLES LIKE 'character_set%';
SHOW CREATE TABLE users;

4. PHP 連線未設定字符集

<?php
// PDO (推薦)
$pdo = new PDO(
    'mysql:host=localhost;dbname=myapp;charset=utf8mb4',
    'user', 'pass',
    [PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION]
);

// mysqli
$mysqli = new mysqli('localhost', 'user', 'pass', 'myapp');
$mysqli->set_charset('utf8mb4'); // 必須在查詢前呼叫

// 舊 mysql_* (已移除) 時代遺留寫法
// mysql_query("SET NAMES utf8mb4");

5. HTTP 響應 Header 缺少 charset

<?php
// 必須在任何輸出前
header('Content-Type: text/html; charset=UTF-8');
// 或 JSON API
header('Content-Type: application/json; charset=UTF-8');

6. 資料匯入/匯出編碼轉換錯誤

<?php
// 匯出 CSV 給 Excel (需 UTF-8 with BOM 或 GBK)
$bom = "\xEF\xBB\xBF"; // UTF-8 BOM
$csv = $bom . implode(',', $headers) . "\n";
foreach ($rows as $row) {
    $csv .= implode(',', array_map(fn($v) => '"' . str_replace('"', '""', $v) . '"', $row)) . "\n";
}
// 或轉 GBK
$csv = iconv('UTF-8', 'GBK//IGNORE', $csv);

7. 前端表單提交編碼

<form accept-charset="UTF-8" ...>

除錯檢查清單

  1. 瀏覽器 Network 面板:檢查 Response Headers `Content-Type` 是否含 `charset=UTF-8`
  2. 瀏覽器開發者工具:Console 執行 `document.characterSet` 確認解碼編碼
  3. 資料庫客戶端:`SELECT HEX(column) FROM table` 檢查實際儲存位元組
  4. PHP 端:`var_dump(bin2hex($str))` 查看字串實際位元組
  5. 檔案編碼:`xxd your.php | head` 檢查 BOM (EF BB BF)

現代最佳實踐:全鏈路 UTF-8

  • 源碼、資料庫、連線、HTTP、頁面、JS/CSS 檔案 全鏈路 UTF-8 (utf8mb4)
  • 拒絕 GB2321/Big5/GBK 等舊編碼,除非對接 legacy 系統
  • 使用 declare(encoding='UTF-8'); 在 PHP 檔案頂部 (PHP 5.3+)
  • Composer 專案:`composer.json` 確保 `"config": {"optimize-autoloader": true}` 不影響編碼
copyright © 萬盛學電腦網 all rights reserved