PHP与Node.js可在本地并行运行,通过HTTP调用、Nginx反向代理、子进程执行、Docker编排或WebSocket通信实现协同。

如果您希望在本地同时运行 PHP 和 Node.js 应用,并实现两者协同工作,例如通过 PHP 调用 Node.js 服务或共享开发端口,需明确二者属于独立运行时环境,不能直接“内置支持”,但可通过进程通信、HTTP 调用或反向代理等方式共存。以下是搭建 PHP 与 Node.js 混合本地开发环境的具体步骤:
一、并行启动独立服务
PHP 和 Node.js 各自启动监听不同端口的 Web 服务,前端通过跨域或代理统一入口访问,避免端口冲突且保持职责分离。
1、使用 PHP 内置服务器启动 PHP 项目:php -S localhost:8000 -t ./public
2、在另一终端中启动 Node.js 服务:node server.js(确保 server.js 中调用 app.listen(3000))
立即学习“PHP免费学习笔记(深入)”;
3、配置前端请求:PHP 页面中通过 fetch('http://localhost:3000/api/data') 调用 Node.js 接口
二、Nginx 反向代理统一路由
Nginx 作为前置网关,将不同路径请求分发至对应后端服务,实现单一域名下的混合路由,规避浏览器跨域限制。
1、安装 Nginx 并编辑 nginx.conf 文件,在 http 块内添加 upstream 定义:
2、为 PHP 添加 location 块:location ~ \.php$ { fastcgi_pass 127.0.0.1:9000; ... }
3、为 Node.js 添加 location 块:location /api/ { proxy_pass http://localhost:3000/; }
4、重启 Nginx:nginx -s reload
三、PHP 执行 Node.js 子进程
利用 PHP 的 exec 或 proc_open 函数在服务端同步或异步调用 Node.js 脚本,适用于数据处理、图像生成等计算型任务。
1、编写 Node.js 工具脚本 process-data.js,接收命令行参数并输出 JSON 结果
2、在 PHP 中执行:$output = shell_exec('node process-data.js ' . escapeshellarg($input));
3、解析返回值:$result = json_decode($output, true);
四、使用 Docker 统一容器编排
通过 docker-compose.yml 定义 PHP-FPM、Node.js 和 Nginx 三个服务,复用同一网络并挂载共享卷,保障环境一致性。
1、创建 docker-compose.yml,定义 php、node、nginx 三个 service
2、在 nginx 配置中设置 proxy_pass http://node:3000 和 fastcgi_pass php:9000
3、执行:docker-compose up -d
五、WebSocket 实时双向通信集成
PHP 后端通过 HTTP 触发事件,Node.js 启动独立 WebSocket 服务,前端连接该服务接收实时推送,实现 PHP 主控、Node.js 承载长连接的分工模式。
1、使用 ws 库启动 Node.js WebSocket 服务:const wss = new WebSocket.Server({ port: 8080 });
2、PHP 在关键操作后发送 HTTP 请求通知 Node.js:file_get_contents('http://localhost:3000/notify?event=order_created');
3、Node.js 接收通知后调用 wss.clients.forEach(client => client.send(...))











