萬盛學電腦網

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

PHP 主動斷開瀏覽器連接實現長任務異步執行

核心原理:HTTP Content-Length + Connection: Close

瀏覽器接收到指定 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') . '] 背景任務結束');
// ===== 後台任務結束 =====

關鍵函數對比

完整生產級背景任務骨架

<?php
// bootstrap.php
ignore_user_abort(true);      // 1. 忽略用戶斷開
set_time_limit(0);            // 2. 無時間限制
session_write_close();        // 3. 釋放 Session 鎖 (若已開啟)

ob_start();
echo json_encode(['status' => 'accepted', 'task_id' => $taskId]);
fastResponseAndDetach();      // 4. 斷開連接

// 5. 核心業務邏輯 (建議封裝為獨立 Service/Job 類)
try {
    // 記錄任務狀態:processing
    $db->update('tasks', ['status' => 'processing', 'started_at' => date('Y-m-d H:i:s')], ['id' => $taskId]);

    // 執行具體工作
    $result = $taskService->execute($taskId, $params);

    // 記錄成功
    $db->update('tasks', ['status' => 'completed', 'result' => json_encode($result), 'finished_at' => date('Y-m-d H:i:s')], ['id' => $taskId]);
} catch (Throwable $e) {
    // 記錄失敗
    $db->update('tasks', ['status' => 'failed', 'error' => $e->getMessage(), 'finished_at' => date('Y-m-d H:i:s')], ['id' => $taskId]);
    error_log("Task $taskId failed: " . $e->getMessage());
}

// 6. 可選:回調/通知前端 (WebSocket、Server-Sent Events、輪詢 API、Webhook)

替代架構:消息隊列 (生產環境推薦)

上述「HTTP 請求中 fork 後台進程」屬 **臨時/低併發** 方案,缺點:

  • 佔用 PHP-FPM worker 進程,高併發導致 worker 耗盡。
  • 無重試、死信、優先級、延遲執行、監控機制。
  • 部署多台機器時任務分散難管理。

標準架構:

HTTP Request → Controller → Push Job to Redis/RabbitMQ/Kafka → Return 202 Accepted
                    ↑
Worker Processes (Supervisor/Horizon/RoadRunner) ← Consume Jobs → Execute → Update Status / Callback

推薦工具:Laravel Horizon (Redis)、Symfony Messenger、RoadRunner (PHP 應用伺服器)、Swoole/OpenSwoole 協程任務。

總結

  • 簡單場景:fastcgi_finish_request() + ignore_user_abort(true) + set_time_limit(0) 三劍客。
  • 生產系統:引入消息隊列 + 專用 Worker,Web 層只負責接收請求、入隊、即時回應。
  • 務必釋放 Session 鎖、關閉輸出緩衝、記錄完整日誌供事後追蹤。
copyright © 萬盛學電腦網 all rights reserved
函數/方法適用環境效果備註
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 秒