PHP 7.0环境下无需pthread实现后台处理的方案咨询

针对PHP 7.0无法使用pcntl_fork和pthread扩展的情况，以下是三种可行的后台处理方案：

方案一：利用系统Shell命令后台执行 #

直接调用服务器的wget或curl命令，将下载任务放到系统后台运行，PHP页面无需等待下载完成即可返回。

// 目标PDF地址与本地保存路径
$pdfUrl = 'https://example.com/large-document.pdf';
$savePath = '/var/www/storage/large.pdf';

// 使用wget后台执行，输出重定向避免阻塞
$command = "wget -O {$savePath} {$pdfUrl} > /var/log/pdf_download.log 2>&1 &";
exec($command);

// 或使用curl替代wget
// $command = "curl -o {$savePath} {$pdfUrl} > /var/log/pdf_download.log 2>&1 &";
// exec($command);

echo '下载任务已在后台启动';

注意事项：

• 确保服务器允许PHP执行exec/shell_exec函数，且未被disable_functions禁用
• 本地保存路径需具备写入权限
• 可将输出重定向到日志文件，方便后续排查下载失败问题

方案二：Redis队列+常驻Worker脚本 #

通过队列解耦Web请求与下载任务，Web端仅负责提交任务，独立的CLI脚本常驻后台消费队列执行下载。

1. Web端提交任务代码 #

$redis = new Redis();
$redis->connect('127.0.0.1', 6379);

// 封装下载任务信息
$task = json_encode([
    'url' => 'https://example.com/large-document.pdf',
    'save_path' => '/var/www/storage/large.pdf',
    'retry_count' => 0
]);

// 将任务推入Redis队列
$redis->lpush('pdf_download_queue', $task);

echo '下载任务已加入队列，后台处理中';

2. 常驻Worker脚本（pdf_download_worker.php） #

$redis = new Redis();
$redis->connect('127.0.0.1', 6379);
set_time_limit(0);

while (true) {
    // 阻塞式取出队列任务，避免空轮询消耗资源
    $taskData = $redis->brpop('pdf_download_queue', 0);
    if (!$taskData) continue;

    $task = json_decode($taskData[1], true);
    $url = $task['url'];
    $savePath = $task['save_path'];

    // 执行下载
    $ch = curl_init($url);
    $fp = fopen($savePath, 'wb');
    curl_setopt($ch, CURLOPT_FILE, $fp);
    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 180); // 设置3分钟超时

    $result = curl_exec($ch);
    $error = curl_error($ch);
    curl_close($ch);
    fclose($fp);

    // 记录日志或处理失败重试
    if (!$result && $task['retry_count'] < 3) {
        $task['retry_count']++;
        $redis->lpush('pdf_download_queue', json_encode($task));
        file_put_contents('/var/log/pdf_download.log', date('Y-m-d H:i:s') . " 下载失败，重试中：{$error}\n", FILE_APPEND);
    } else {
        file_put_contents('/var/log/pdf_download.log', date('Y-m-d H:i:s') . " 下载完成：{$savePath}\n", FILE_APPEND);
    }
}

3. 启动Worker #

在服务器终端执行以下命令，让脚本后台常驻：

php /var/www/scripts/pdf_download_worker.php &

建议使用supervisor工具管理Worker进程，防止意外退出后自动重启。

方案三：FastCGI异步请求（Nginx+PHP-FPM环境） #

通过curl发起一个超时极短的异步请求到下载脚本，原页面直接返回，下载脚本在后台继续执行。

原页面代码 #

// 下载脚本的内部访问地址
$downloadScript = 'http://localhost/internal/download_pdf.php';

$ch = curl_init($downloadScript);
curl_setopt($ch, CURLOPT_URL, $downloadScript);
curl_setopt($ch, CURLOPT_TIMEOUT, 1); // 仅等待1秒，不阻塞原页面
curl_setopt($ch, CURLOPT_NOSIGNAL, 1); // 避免信号中断
curl_exec($ch);
curl_close($ch);

echo '下载任务已启动';

下载脚本（download_pdf.php） #

// 忽略客户端断开连接
ignore_user_abort(true);
// 取消执行时间限制
set_time_limit(0);

$pdfUrl = 'https://example.com/large-document.pdf';
$savePath = '/var/www/storage/large.pdf';

// 执行下载
$ch = curl_init($pdfUrl);
$fp = fopen($savePath, 'wb');
curl_setopt($ch, CURLOPT_FILE, $fp);
curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
curl_exec($ch);
curl_close($ch);
fclose($fp);

注意事项：

• 需确保PHP-FPM的request_terminate_timeout配置足够长，避免下载过程中被强制终止
• 该方案稳定性略低于队列或Shell命令方式，适合简单场景

内容的提问来源于stack exchange，提问作者Harshit