PHP执行Node.js脚本并实时回传进度的教程

风辰酱_2539

风辰酱_2539

2026-04-27

746人浏览

原创

php实时获取node.js进度需用proc_open流式读取、命名管道、http长轮询、websocket或redis pub/sub五种方案,核心是避免exec阻塞并实现输出即时传递。

php执行node.js脚本并实时回传进度的教程

如果您希望在 PHP 中执行 Node.js 脚本,并实时获取其运行过程中的进度输出(如日志、百分比、状态标记等),而非仅等待最终结果,这需要绕过 exec() 等同步阻塞函数的限制,改用支持流式读取的进程控制方式。以下是实现该目标的具体操作步骤:

一、使用 proc_open 捕获标准输出流

proc_open 允许 PHP 启动一个子进程并建立管道连接,从而持续读取 stdout(标准输出)和 stderr(标准错误),实现真正的实时回传。Node.js 脚本需主动调用 console.log() 或 process.stdout.write() 输出进度信息,PHP 侧则循环非阻塞读取。

1、确认 Node.js 可执行文件的绝对路径,例如通过终端执行 which node 获取;

2、确保 Node.js 脚本中每条进度输出后调用 process.stdout.flush(),避免缓冲导致延迟;

3、在 PHP 中定义描述符数组,启用 stdin、stdout、stderr 三路管道;

4、调用 proc_open() 启动进程,传入完整命令(含绝对路径)及描述符配置;

5、使用 stream_select() 监听 stdout 流是否就绪,一旦可读即用 fgets() 或 fread() 获取最新一行或一段内容;

6、在每次读取后立即输出或推送到前端(如通过 chunked transfer encoding 或 SSE);

7、当进程退出时,调用 proc_close() 清理资源并获取返回码。

二、通过命名管道(FIFO)解耦通信

命名管道可在 PHP 与 Node.js 进程之间建立持久、单向或双向的数据通道,适用于长时间运行且需高频进度上报的场景。PHP 作为读端打开 FIFO 文件,Node.js 作为写端持续写入,双方无需共享内存或进程上下文。

1、在服务器上创建命名管道:执行 mkfifo /tmp/node_progress_pipe;

2、设置适当权限,确保 PHP 运行用户(如 www-data)对该 FIFO 具有读取权限;

3、修改 Node.js 脚本,在关键进度点执行 fs.createWriteStream('/tmp/node_progress_pipe').write('progress:65%\n');

4、PHP 中以只读阻塞模式打开该 FIFO:$fp = fopen('/tmp/node_progress_pipe', 'r');

5、使用 fgets($fp) 持续读取每一行,每读到一条即转发至响应流;

6、Node.js 进程退出后,PHP 侧 fclose($fp) 即可自动终止读取循环。

三、基于 HTTP 长轮询 + 内存共享状态

此方法将 Node.js 脚本转为独立后台服务,PHP 不直接执行它,而是通过轻量级 HTTP 接口触发任务并轮询进度状态。进度数据暂存于共享存储(如 APCu、Redis 或临时文件),实现进程隔离与高可靠性。

1、编写一个 Node.js HTTP 服务,监听 POST /start 执行脚本,并将当前进度写入 apcu_store('task_progress', ['status'=>'running','percent'=>30]);

2、PHP 发起 curl 请求启动任务,获取唯一 task_id;

用于自动切换项目中适合的node 版本
用于自动切换项目中适合的node 版本

根据 package.json 中的 engines 字段自动检测 Node.js 版本需求,未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。

下载

3、PHP 前端发起长轮询请求至 /progress?task_id=xxx,后端用 apcu_fetch('task_progress') 读取并返回 JSON;

4、Node.js 脚本内部每完成一个阶段,更新 APCu 中对应键值;

5、PHP 轮询接口返回 HTTP 200 并携带最新 percent 字段,前端实时渲染;

6、当 status 变为 done 时,轮询终止,PHP 清理 APCu 键。

四、利用 WebSocket 实现双向实时推送

当需要毫秒级响应与低延迟反馈时,可部署独立 WebSocket 服务(推荐 Node.js 的 ws 库),PHP 触发任务后,Node.js 脚本直连该服务推送进度,PHP 后端或前端通过 WebSocket 客户端接收消息。

1、启动一个 WebSocket 服务器,监听端口 8081,维护客户端连接列表;

2、PHP 在调用 Node.js 脚本前生成唯一 session_id,并通过 GET 参数传递给脚本;

3、Node.js 脚本启动后,使用 new WebSocket('ws://localhost:8081/?sid=abc123') 连接服务端;

4、PHP 后端或前端 WebSocket 客户端订阅同一 sid,接收服务端广播的进度帧;

5、Node.js 脚本每输出一次进度,调用 ws.send(JSON.stringify({type:'progress',value:72}));

6、服务端收到后,查找匹配 sid 的所有连接,并逐个推送该消息。

五、采用 Redis Pub/Sub 异步广播进度

Redis 提供轻量、高性能的消息总线能力,适合多实例 PHP 环境下统一接收 Node.js 进程发布的进度事件,避免文件锁或进程依赖问题。

1、确保 Redis 服务已运行,PHP 与 Node.js 均能访问同一 Redis 实例;

2、Node.js 脚本中引入 redis 模块,初始化客户端后,在进度点执行 client.publish('progress:task_456', '88%');

3、PHP 使用 redis扩展创建 pubsub 实例,调用 $redis->subscribe(['progress:task_456'], $callback);

4、定义回调函数,在其中处理每条收到的进度字符串并刷新响应;

5、PHP 进程保持订阅状态,直到收到结束信号或超时断开;

6、Node.js 脚本结束后自动停止发布,PHP 侧可检测空消息或显式结束标记终止循环。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php js node.js node

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

11084

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

6441

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2155

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

4068

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4794

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3751

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

5397

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

4222

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

12142

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习