PHP中single-threaded process的含义及请求阻塞致应用停滞的解析与示例

The web server runs only one single-threaded process, so PHP applications will stall if a request is blocked.

1. PHP场景下"single-threaded process"的确切含义 #

这里的"single-threaded process"指的是Web服务器以单进程+单线程的模式运行：

• 服务器仅启动一个进程来处理所有请求
• 该进程只有一个执行线程，同一时间只能处理一个请求
• 新请求必须等待当前请求完全处理完成后才能开始执行

这种模式和生产环境常见的多进程/多线程服务器（比如Apache的prefork模式、Nginx+PHP-FPM）不同，后者可以同时处理多个请求。PHP本身的默认执行模型是同步单线程的，但这里的核心限制来自Web服务器的运行模式，而非PHP语言本身。

2. 请求何时、以何种方式被阻塞？哪些应用会因此停滞？ #

请求阻塞的场景 #

只要当前请求的执行流程进入等待状态且无法让出服务器控制权，就会造成阻塞，常见情况包括：

• 同步IO等待：比如调用响应缓慢的远程API、执行无索引的慢数据库查询、同步读取大文件、等待文件锁/数据库锁释放
• 长时间计算：脚本包含无限循环、复杂耗时的数学运算
• 主动休眠：调用sleep()、usleep()等强制暂停执行的函数

哪些应用会停滞？ #

所有后续发送到服务器的请求都会停滞。因为单线程进程被当前阻塞的请求占用，无法处理新请求，直到阻塞状态解除。

示例说明 #

示例1：同步调用慢API

<?php
// slow_api.php
// 调用一个需要10秒才能响应的外部接口
$response = file_get_contents('https://example.com/slow-service');
echo $response;
?>

• 用PHP内置单线程服务器启动：php -S localhost:8000
• 同时在两个浏览器标签页访问该脚本：第一个标签页需等待10秒返回结果，第二个标签页会被完全阻塞，直到第一个请求完成后才开始处理，总等待时间超过10秒。

示例2：休眠模拟阻塞

<?php
// sleep_demo.php
// 强制脚本休眠15秒
sleep(15);
echo "执行完成！";
?>

• 连续发送两个请求：第一个请求15秒后返回，第二个请求必须等第一个请求结束才会启动，实际等待时间接近30秒。

示例3：慢数据库查询

<?php
// slow_db.php
$pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'password');
// 查询无索引的大表，预计耗时20秒
$stmt = $pdo->query('SELECT * FROM large_table WHERE unindexed_field = "test"');
$result = $stmt->fetchAll();
echo "查询到 ".count($result)." 条数据";
?>

• 执行期间，服务器无法处理任何其他请求，所有后续请求都会进入等待队列，直到数据库查询完成。

注：这种单线程服务器模式多见于开发环境（比如PHP内置服务器）或极低流量的小型服务。生产环境通常采用多进程/多线程架构，单个请求阻塞不会影响其他请求的处理。

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