PHP ob_gzhandler 與 zlib.output_compression 衝突解決方案

錯誤信息

PHP Warning: ob_start(): output handler 'ob_gzhandler' conflicts with 'zlib output compression' in ...
// 或
output handler 'ob_gzhandler' conflicts with 'zlib output compression'

衝突原因

同時啟用了兩種 GZIP 壓縮方式：

1. zlib.output_compression = On (php.ini 全局壓縮)
2. ob_start('ob_gzhandler') (代碼級輸出緩衝壓縮)

兩者嘗試對同一輸出流進行雙重壓縮，導致衝突。

解決方案

方案一：關閉 zlib.output_compression (推薦)

; php.ini
zlib.output_compression = Off
; zlib.output_compression_level = -1

; 代碼中使用 ob_gzhandler
ob_start('ob_gzhandler');

方案二：關閉 ob_gzhandler，使用 zlib 全局壓縮

; php.ini
zlib.output_compression = On
zlib.output_compression_level = 6  ; 1-9, 6 平衡

; 代碼中移除 ob_start('ob_gzhandler')
// ob_start(); // 普通緩衝即可

方案三：代碼中動態控制 (無權限改 php.ini)

<?php
// 在任何輸出前
ini_set('zlib.output_compression', '0'); // 關閉 zlib 壓縮
ob_start('ob_gzhandler'); // 啟用 ob_gzhandler

// 或反向
ini_set('zlib.output_compression', '1');
ini_set('zlib.output_compression_level', '6');
ob_start(); // 不要用 ob_gzhandler
?>

兩種壓縮方式對比

現代最佳實踐：Nginx/Apache 層面壓縮

# Nginx 配置 (推薦，性能最好，脫離 PHP)
gzip on;
gzip_vary on;
gzip_min_length 1024;
gzip_comp_level 6;
gzip_types text/plain text/css application/json application/javascript text/xml application/xml application/xml+rss text/javascript;

# Apache 配置 (mod_deflate)

    AddOutputFilterByType DEFLATE text/html text/plain text/xml text/css text/javascript application/javascript application/json

PHP 5.4+ 內置 Web 服務器

# 啟動內置服務器 (不支持 gzip)
php -S localhost:8000

# 生產環境絕不使用內置服務器

驗證壓縮生效

# curl 測試
curl -H "Accept-Encoding: gzip,deflate" -I https://example.com/
# 應包含：Content-Encoding: gzip

# 瀏覽器 F12 Network → Response Headers
# Content-Encoding: gzip
# Vary: Accept-Encoding

避坑檢查清單

1. ✅ php.ini 中 `zlib.output_compression = Off`
2. ✅ 代碼中僅使用一種壓縮方式
3. ✅ 生產環境優先使用 Web 服務器 (Nginx/Apache) 壓縮
4. ✅ 檢查 `phpinfo()` 中 zlib 區塊確認配置
5. ✅ 測試 `Accept-Encoding: gzip` 請求正確返回壓縮內容