萬盛學電腦網

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

PHP 設定頁面編碼的兩種標準方法 (header vs meta)

前言

正確設定頁面字元編碼可避免中文亂碼,確保瀏覽器正確解碼顯示。PHP 提供兩種主要方式:HTTP 標頭 與 HTML meta 標籤。兩者優先級與適用場景不同,需正確理解。

方法一:PHP header() 函數 (伺服器端,優先級最高)

<?php
// 必須在任何輸出 (echo、HTML、空白) 之前呼叫
header('Content-Type: text/html; charset=utf-8');

// 或分開設定 (同等效果)
header('Content-Type: text/html');
header('charset: utf-8');

優點:

  • HTTP 回應標頭,瀏覽器**最優先**遵循
  • 適用於所有輸出類型 (HTML、JSON、XML、CSV 等)
  • 可動態根據條件切換編碼

注意:必須在 **任何輸出之前** 呼叫,否則會觸發 Cannot modify header information - headers already sent 警告。

方法二:HTML meta 標籤 (客戶端,次要)

<!-- HTML5 簡潔寫法 (推薦) -->
<meta charset="utf-8">

<!-- HTML4/XHTML 相容寫法 -->
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

優點:

  • 檔案本身攜帶編碼資訊,離線開啟也能正確顯示
  • 不依賴伺服器端設定

缺點:

  • 瀏覽器需先下載部分內容才能解析 meta,可能造成初期誤判
  • 若 HTTP 標頭與 meta 衝突,**HTTP 標頭優先**

最佳實踐:雙重保險

<?php
// 1. PHP 最早期設定 HTTP 標頭
header('Content-Type: text/html; charset=utf-8');
?>
<!DOCTYPE html>
<html>
<head>
    <!-- 2. HTML meta 作為備援 -->
    <meta charset="utf-8">
    <title>頁面標題</title>
</head>
<body>
    內容...
</body>
</html>

常見場景對照

場景推薦方式說明
一般 HTML 頁面header + meta 雙重最保險
API 回傳 JSONheader('Content-Type: application/json; charset=utf-8')無 HTML,meta 無效
API 回傳 XMLheader('Content-Type: application/xml; charset=utf-8')XML 宣告 亦需一致
檔案下載header('Content-Type: application/octet-stream')通常不涉及字元編碼
舊專案維護 (GBK/Big5)header 設定對應編碼 + meta 同步資料庫/檔案編碼須一致

進階:MVC 框架中的統一設定

<?php
// 基底控制器
class BaseController {
    public function __construct() {
        // 統一設定編碼
        header('Content-Type: text/html; charset=utf-8');
        
        // 或僅設定 charset (保留原 Content-Type)
        // header('charset: utf-8');
    }
}

// 或者在入口檔案統一設定
// public/index.php
header('Content-Type: text/html; charset=utf-8');
// ... 後續啟動框架

編碼相關完整配置清單

為徹底解決亂碼,需確保 **全鏈路 UTF-8** (或統一目標編碼):

  1. PHP 檔案編碼:編輯器儲存為 UTF-8 無 BOM
  2. PHP 內部編碼:mb_internal_encoding('UTF-8')
  3. 資料庫連線:SET NAMES utf8mb4 / PDO DSN charset=utf8mb4
  4. 資料表/欄位編碼:CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
  5. HTTP 輸出:header('Content-Type: ...; charset=utf-8')
  6. HTML meta:<meta charset="utf-8">
  7. 表單提交:<form accept-charset="utf-8">
  8. JavaScript/JSON:確保檔案編碼與傳輸編碼一致

快速診斷亂碼步驟

  1. 瀏覽器開發者工具 → Network → Response Headers → 確認 Content-Type 含 charset=utf-8
  2. 瀏覽器 → View Source → 檢查 <meta charset> 是否存在且正確
  3. 資料庫客戶端直接查詢 → 確認資料儲存無誤
  4. PHP 變數輸出檢查 → var_dump($str) 看長度與內容
  5. 檢查 PHP 檔案本身編碼 (編輯器右下角)
copyright © 萬盛學電腦網 all rights reserved