PHP 頁面 UTF-8 中文亂碼徹底解決：Header、檔案編碼、BOM、資料庫、附件下載全鏈路指南

• session_start() 失敗：Cannot send session cache limiter - headers already sent
• header()、setcookie() 失效
• 頁面頂部出現隱形空白或 

移除方法：

• 編輯器另存為 **UTF-8 無 BOM**
• 命令列批次移除：find . -name "*.php" -exec sed -i '1s/^\xEF\xBB\xBF//' {} \;

4. MySQL 連線與資料表編碼

$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'user', 'pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"
]);

• 資料庫/資料表/欄位建議 **utf8mb4**（支援 Emoji、生僻字）
• 避免舊版 utf8（實為 utf8mb3，僅 3 字節）
• 舊專案 mysql_query("SET NAMES UTF8") 改為 SET NAMES utf8mb4

5. 附件下載：中文檔名編碼處理

$filename = '中文報表.xlsx';
$encoded = rawurlencode($filename); // RFC 5987 標準

header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header("Content-Disposition: attachment; filename*=UTF-8''{$encoded}");
header('Content-Length: ' . filesize($filepath));
readfile($filepath);

舊瀏覽器兼容：

$ua = $_SERVER['HTTP_USER_AGENT'];
if (preg_match('/MSIE|Trident/', $ua)) {
    $filename = iconv('UTF-8', 'GBK', $filename); // IE 老版本
    header("Content-Disposition: attachment; filename=\"$filename\"");
} else {
    header("Content-Disposition: attachment; filename*=UTF-8''{$encoded}");
}

6. 字符串截取：mb_substr 替代 substr

function utf8_substr($str, $len) {
    return mb_substr($str, 0, $len, 'UTF-8');
}
// 或通用函數
function msubstr($str, $start, $len, $charset = 'UTF-8', $suffix = true) {
    $slice = mb_substr($str, $start, $len, $charset);
    return $suffix && mb_strlen($str, $charset) > $len ? $slice . '...' : $slice;
}

完整排查清單（按優先級）

1. header('Content-Type: text/html; charset=UTF-8') 在最頂部
2. 所有 PHP/HTML/JS/CSS 檔案存為 **UTF-8 無 BOM**
3. 資料庫連線 SET NAMES utf8mb4，表欄位 utf8mb4_unicode_ci
4. 資料庫、表、欄位編碼一致性檢查
5. 表單頁 <meta charset="UTF-8"> + accept-charset="UTF-8"
6. 所有 iconv/mb_convert_encoding 來源/目標編碼正確
7. 下載檔名用 filename*=UTF-8'' 格式
8. JSON 輸出 json_encode($data, JSON_UNESCAPED_UNICODE)

常見誤區

1. 上一篇文章： PHP mail() 發送 UTF-8 中文郵件主旨亂碼：RFC 2047 編碼標準解決方案
2. 下一篇文章： PHP 限制文件下載速度：節省頻寬、實現進度條、防盜鏈的流控技術

PHP 綜合知識

PHP微信公眾號發紅包接口對接：商戶號配置、證書部署、完整調用流程

前置條件 微信商戶號已開通微信支付 商戶號綁定的公眾號（服

PHP 環境配置全攻略：Windows 下 Apache 2.2 + PHP 5.2 + MySQL 5.0 + phpMyAdmin 安裝圖文教程

前言 本教程記錄在 Windows XP 環境下，手動安裝配

Windows 系統下快速搭建 PHP 開發環境：新手指南

PHP 簡介 PHP 獨特的語法融合了 C、Java、Per

PHP數組操作三種方案對比：統計字符串字符出現次數

題目 統計字符串 as5454654%^$%^$7675dh