萬盛學電腦網

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

PHP UTF-8 BOM (Byte Order Mark) 導致輸出異常的問題與解決

現象

  • 頁面頂端出現空白行、亂碼 、或「Cannot modify header information - headers already sent」
  • Session 啟動失敗、setcookie() 無效
  • XML/JSON 輸出解析錯誤

什麼是 BOM?

Byte Order Mark (BOM) 是 UTF-16/UTF-32 標識位元組序的標記。UTF-8 雖無位元組序問題,但部分編輯器(如早期 Dreamweaver、Notepad)預設在 UTF-8 檔案開頭寫入 EF BB BF 三個位元組作為標識。

為何 PHP 會出問題?

PHP 解析器將 BOM 視為輸出內容,導致「輸出已開始」,後續 header()、session_start()、setcookie() 失效。PHP 7.1+ 可自動忽略開頭 BOM,但舊版本或特定 SAPI 仍受影響。

解決方案

1. 編輯器設定(根治)

  • VS Code:右下角編碼選單 → 「以編碼儲存」→ 選 UTF-8 (無 BOM)
  • PhpStorm:File → File Encoding → UTF-8,取消「Add BOM」
  • Sublime Text:File → Save with Encoding → UTF-8
  • Notepad++:編碼 → 轉為 UTF-8 (無 BOM)
  • Dreamweaver:儲存對話框取消勾選「包含 Unicode 簽名 (BOM)」

2. 專案層面強制檢查

# .gitattributes 強制所有 PHP/HTML/JS/CSS 為無 BOM
*.php    text eol=lf
*.html   text eol=lf
*.js     text eol=lf
*.css    text eol=lf
*.xml    text eol=lf

3. CI/CD 自動偵測

# 檢查專案中是否含 BOM
grep -r $'\xEF\xBB\xBF' --include="*.php" --include="*.html" .
# 或用 PHP 腳本掃描
php -r "foreach (new RecursiveIteratorIterator(new RecursiveDirectoryIterator('.')) as \$f) { if (\$f->isFile() && preg_match('/\.(php|html|xml|js|css)$/', \$f)) { \$c = file_get_contents(\$f); if (substr(\$c, 0, 3) === '\xEF\xBB\xBF') echo \$f->getPathname() . PHP_EOL; } }"

4. 運行時緩衝區清理(應急)

<?php
// 放在入口檔最頂端(

最佳實踐

  1. 團隊統一編輯器設定,納入開發規範文檔。
  2. Git pre-commit hook 自動剝離 BOM。
  3. 所有 PHP 檔案嚴格以 <?php 開頭,前面零字元。
copyright © 萬盛學電腦網 all rights reserved