瀏覽器接收到指定 Content-Length 大小的回應體後,認為傳輸完成,配合 Connection: Close 立即關閉連接,PHP 腳本在後台繼續執行長耗時任務。
<?php
/**
* 快速回應並斷開連接,後台繼續執行
* 適用:發送郵件、生成報表、推送通知、視頻轉碼等耗時任務
*/
function fastResponseAndDetach(string $responseBody = 'OK', int $statusCode = 200): void
{
// 1. 獲取輸出緩衝區長度
$size = ob_get_length();
if ($size === false) {
// 無輸出緩衝,手動計算
$size = strlen($responseBody);
}
// 2. 發送關鍵 Header
header("Content-Length: $size");
header('Connection: Close');
header('Content-Type: text/plain; charset=utf-8'); // 根據實際輸出調整
// 3. 刷新所有緩衝區到客戶端
ob_flush();
flush();
// 4. 關閉 FastCGI 連接 (PHP-FPM 環境關鍵)
if (function_exists('fastcgi_finish_request')) {
fastcgi_finish_request(); // 關鍵:通知 Web Server 關閉連接,PHP 進程繼續運行
}
// 5. 此後代碼在後台繼續執行,瀏覽器已收到回應並斷開
// 注意:此時不應再有任何輸出 (echo/print/var_dump 等)
}
// 使用範例
ob_start(); // 必須啟用輸出緩衝
echo '請求已接收,正在後台處理...';
fastResponseAndDetach();
// ===== 後台長任務開始 =====
error_log('[' . date('Y-m-d H:i:s') . '] 背景任務開始');
// 模擬耗時操作
sleep(5);
// 發送郵件、生成 PDF、呼叫外部 API 等
// sendMail(...);
// generateReport(...);
error_log('[' . date('Y-m-d H:i:s') . '] 背景任務結束');
// ===== 後台任務結束 =====
| 函數/方法 | 適用環境 | 效果 | 備註 |
|---|---|---|---|
header('Content-Length') + header('Connection: Close') + flush() | 所有 SAPI | 通知瀏覽器內容結束 | 基礎手段,Apache mod_php 通常有效 |
fastcgi_finish_request() | PHP-FPM (Nginx/Apache+FastCGI) | **真正釋放 Web Server 進程**,PHP 進程繼續 | **生產環境首選**,需 PHP 5.4+ |
session_write_close() | 所有 | 釋放 Session 鎖,允許同用戶並發請求 | 長任務前必須調用,否則同用戶其他請求阻塞 |
ignore_user_abort(true) | 所有 | 用戶關閉瀏覽器/取消請求時,腳本**不終止**繼續執行 | 關鍵:防止用戶關頁導致任務中斷 |
set_time_limit(0) | 所有 | 移除腳本最大執行時間限制 | 長任務必須,預設 30 秒 |