如何通过PHP后台执行npm start并让后续代码正常运行？

算力阿峰

2026-6-26

解决PHP后台启动React服务器不阻塞后续代码的问题

问题原因

exec()函数默认会等待执行的命令进程结束才会继续执行后续PHP代码，而npm start是启动持续运行的开发服务器，不会主动退出，直接调用会导致后续代码被阻塞。

可行解决方案

1. 调整Windows下的命令写法

要让npm start完全在后台运行且不占用PHP的进程管道，需要修改命令，将输出重定向到空设备，同时让进程脱离当前控制台：

mkdir('hello');
// 后台启动React服务器，重定向输出避免阻塞
exec('start /B cmd.exe /C "npm start > NUL 2>&1"');
mkdir('hi');

> NUL：将标准输出重定向到空设备，避免输出内容占用管道
2>&1：将错误输出重定向到标准输出，一起丢到空设备，确保无输出残留导致阻塞
用双引号包裹命令，避免空格等特殊字符导致命令解析错误

2. 等待服务器启动完成（可选，适配Puppeteer截图需求）

如果后续Puppeteer截图需要服务器完全就绪，可添加端口轮询逻辑：

mkdir('hello');
exec('start /B cmd.exe /C "npm start > NUL 2>&1"');

// 轮询等待React服务器启动（默认端口3000）
$port = 3000;
$maxAttempts = 20;
$attempts = 0;
while ($attempts < $maxAttempts) {
    $connection = @fsockopen('localhost', $port);
    if ($connection) {
        fclose($connection);
        break;
    }
    $attempts++;
    sleep(1); // 每次等待1秒
}

mkdir('hi');
// 后续执行Puppeteer截图逻辑

3. 跨平台兼容写法（如果需部署到Linux/macOS）

可通过判断系统类型适配不同命令：

mkdir('hello');
if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN') {
    // Windows环境
    exec('start /B cmd.exe /C "npm start > NUL 2>&1"');
} else {
    // Linux/macOS环境
    exec('npm start > /dev/null 2>&1 &');
}
mkdir('hi');