萬盛學電腦網

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

PHP 輸出亂碼徹底解決:編碼一致性三步驟

亂碼產生根本原因

瀏覽器顯示編碼 ≠ 網頁實際編碼 ≠ PHP 內部編碼 ≠ 資料庫編碼 ≠ 檔案儲存編碼。任一環節不一致,即產生亂碼 (、、亂碼字符)。

三步驟徹底解決

步驟 1:PHP 宣告輸出編碼 (最關鍵、最優先)

<?php
// 檔案最頂端,任何輸出之前
header('Content-Type: text/html; charset=UTF-8');
// 或
header('Content-Type: application/json; charset=UTF-8'); // API
  • HTTP 標頭優先級最高,瀏覽器會忽略 HTML meta 標籤。
  • 必須在 任何 echo/print/HTML/空白輸出前 呼叫,否則產生 "Headers already sent" 警告。

步驟 2:HTML 頁面宣告編碼

<!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">

步驟 3:確保檔案儲存編碼為 UTF-8 (無 BOM)

  • 編輯器 (VS Code/PhpStorm/Sublime/Notepad++) 右下角選 **UTF-8 (without BOM)**。
  • BOM (Byte Order Mark) 會導致 PHP 輸出隱形字符,破壞 HTTP 標頭、JSON 格式、XML 宣告,嚴禁使用 UTF-8 with BOM。
  • 批次轉換指令:find . -name "*.php" -exec iconv -f BIG5 -t UTF-8 {} -o {}.utf8 \;

資料庫編碼一致性 (MySQL/MariaDB 為例)

-- 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 輸出中文變 \uXXXXjson_encode 預設轉義 Unicodejson_encode($data, JSON_UNESCAPED_UNICODE)
header() 失效、警告header 前有輸出 (空白、BOM、echo)檢查檔案開頭、關閉標籤、include 檔案

除錯檢查清單

  1. php -i | grep -i charset 確認 PHP 內建預設編碼。
  2. 瀏覽器開發工具 Network 標籤 → Response Headers → Content-Type 是否含 charset=UTF-8。
  3. 瀏覽器手動切換編碼 (View → Encoding) 觀察是否正常,若正常則為宣告缺失。
  4. var_dump(mb_detect_encoding($str)) 檢測字串實際編碼。
  5. 資料庫 SHOW VARIABLES LIKE 'character_set%'; SHOW CREATE TABLE users; 確認全鏈路一致。

結語

「UTF-8 無 BOM,全鏈路一致」是解決 PHP 亂碼的鐵律。建立專案時即配置編輯器、資料庫、PHP、Web Server、前端模板統一 UTF-8,並以 header() 為最高優先級宣告,即可一勞永逸。若遺留專案混雜編碼,建議以 iconv 或 mb_convert_encoding 批次轉碼,再統一入口設定。

copyright © 萬盛學電腦網 all rights reserved