萬盛學電腦網

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

PHP 輸出亂碼終極解決方案:header 設定 charset

PHP 輸出中文亂碼是新手最常遇到的問題。根本原因是瀏覽器預設編碼與頁面實際編碼不一致。本文提供最直接有效的解決方案。

核心解法:一行 header

<?php
// 必須在「任何輸出之前」放在檔案最頂端
header("Content-Type: text/html; charset=UTF-8");

// 後續輸出中文即正常
echo "中文測試:你好世界!";
?>

編碼對應表

⚠️ 絕對要注意的陷阱

header() 必須在任何輸出之前!

以下情況都會導致 Cannot modify header information - headers already sent 錯誤:

  • HTML 標籤、空白、換行在 <?php 之前
  • echo, print, var_dump 等輸出函式在 header 之前
  • PHP 結束標籤 ?> 後有空白行 (建議純 PHP 檔案省略 ?>)
  • include/require 的檔案有輸出或 BOM
  • 錯誤訊息、警告輸出在 header 之前

檢查清單

  1. 檔案儲存編碼 = UTF-8 無 BOM (編輯器右下角確認)
  2. header() 在檔案最開頭,前面零輸出
  3. 資料庫連線設定 SET NAMES utf8mb4
  4. 資料表/欄位編碼為 utf8mb4
  5. HTML meta 標籤一致:<meta charset="UTF-8">

進階:統一管理編碼設定

<?php
// config.php - 專案通用設定
declare(strict_types=1);

// 1. 設定內部編碼
mb_internal_encoding('UTF-8');
mb_http_output('UTF-8');
mb_regex_encoding('UTF-8');

// 2. 輸出 header (若非 CLI 模式)
if (PHP_SAPI !== 'cli') {
    header('Content-Type: text/html; charset=UTF-8');
}

// 3. 資料庫連線統一設定 charset
// PDO: new PDO("mysql:host=...;charset=utf8mb4", ...)
// mysqli: $mysqli->set_charset('utf8mb4');
?>

常見誤區

  • ❌ 以為 <meta charset="UTF-8"> 就夠了 → 瀏覽器優先看 HTTP 標頭
  • ❌ 用 ob_start() 包起來就能隨便輸出 → 只是緩衝,header 仍需在實際輸出前
  • ❌ 只有部分頁面加 header → 必須每個輸出頁面都加,或用共用設定檔
copyright © 萬盛學電腦網 all rights reserved
頁面編碼header 設定
UTF-8 (推薦)header("Content-Type: text/html; charset=UTF-8");
Big5 (繁體中文舊系統)header("Content-Type: text/html; charset=Big5");
GBK/GB2312 (簡體中文舊系統)header("Content-Type: text/html; charset=GBK");