PHP 主動斷開瀏覽器連接實現長任務異步執行：Content-Length 與 Connection 技術詳解

當 PHP 需執行耗時任務（如發郵件、生成報表、視頻轉碼）時，不希望用戶等待頁面加載完成。本文詳解利用 HTTP 協議特性，讓瀏覽器「以為請求結束」實際 PHP 繼續後台執行的技術原理與代碼模式。

核心原理

• Content-Length：告知瀏覽器響應體長度，瀏覽器接收滿該長度即斷開連接，停止等待。
• Connection: Close：明確告知瀏覽器關閉 TCP 連接（短連接），避免 Keep-Alive 導致瀏覽器保持連接等待。
• 輸出緩衝控制：ob_get_length() 獲取已輸出長度，ob_flush() + flush() 強制發送到瀏覽器。

標準實現模板

<?php
// 1. 輸出給用戶的即時反饋
echo '任務已接收，正在後台處理...';

// 2. 斷開連接關鍵代碼
$size = ob_get_length();
header("Content-Length: $size");
header("Connection: Close");
ob_flush();
flush();

// 3. 可選：fastcgi_finish_request() (PHP-FPM 環境下更可靠)
if (function_exists('fastcgi_finish_request')) {
    fastcgi_finish_request();
}

// 4. 後台長時間任務
error_log("[" . date("Y-m-d H:i:s") . "] 背景任務開始");
sleep(5); // 模擬耗時操作
error_log("[" . date("Y-m-d H:i:s") . "] 背景任務結束");
// 這裡的 echo 瀏覽器不會收到
?>

關鍵差異說明

生產環境最佳實踐

1. 使用 fastcgi_finish_request() 作為首選（PHP-FPM 環境）。
2. 配合 ignore_user_abort(true) 確保任務不因客戶端斷開而中止。
3. 將長任務放入消息隊列，由獨立 Worker 消費（更穩健、可擴展、可監控）。
4. 輸出前務必 ob_start() 開啟緩衝，確保 ob_get_length() 準確。

常見坑點

• 已發送 Header 後無法再發送 Header —— 確保斷開代碼在任何 header() / setcookie() 之前，或開啟 output_buffering。
• 壓縮模塊 mod_deflate/gzip 會改變實際傳輸長度，導致 Content-Length 不匹配 —— 關閉壓縮或使用 fastcgi_finish_request() 繞過。
• Nginx proxy_buffering / fastcgi_buffering 可能延遲發送 —— 設置 proxy_buffering off 或 fastcgi_buffering off。

掌握 HTTP 協議層面的連接控制，是實現「即時響應 + 後台異步」用戶體驗的關鍵技能。