PHP用RoadRunner运行进程全解析

本文深入解析了为何不能将 Laravel 的 php artisan serve 用于生产环境——因其单进程、无连接复用、不支持平滑重启，完全无法应对真实并发压力；转而推荐基于 Go 构建的高性能常驻进程服务器 RoadRunner，它通过复用 PHP worker 显著降低框架加载与自动加载开销，大幅提升吞吐与稳定性。文章手把手指导如何在 Laravel 9+ 中正确集成 RoadRunner，涵盖二进制安装、rr.php 入口原理、关键配置项（如监听地址、worker 数量、生命周期控制及 RPC 启用）的避坑要点，并给出调试 worker 崩溃的三大实战技巧：启用 --debug 模式、持久化 PHP 错误日志、强制开启 CLI 模式下的 opcache，同时强调上线前必须关闭 APP_DEBUG 并统一日志输出通道——帮你避开 502、Connection refused、Worker exit 255 等高频故障，真正实现 Laravel 应用的高性能、高可用生产部署。

为什么不能直接用 php artisan serve 跑生产环境

因为 php artisan serve 是 Laravel 自带的开发用 PHP 内置服务器，单进程、无连接复用、不支持平滑重启，一请求一 CGI 启动，扛不住并发。RoadRunner 是基于 Go 的高性能应用服务器，它把 PHP 进程常驻在内存里，用 worker 模式复用，省掉每次加载框架和 autoloader 的开销。

常见错误现象：502 Bad Gateway（RoadRunner 没起来或 PHP worker 崩了）、Connection refused（.rr.yaml 配置端口被占或没监听）、Worker exited with code 255（PHP 启动时报错，比如扩展缺失或 bootstrap/app.php 报致命错误）。

怎么让 Laravel 正确对接 RoadRunner

Laravel 默认入口是 public/index.php，但 RoadRunner 要求你提供一个可长期运行的 PSR-7 兼容 HTTP handler。Laravel 9+ 已原生支持，只需两步：

• 确保已安装 spiral/roadrunner-binary（推荐用 composer require spiral/roadrunner-binary --dev），它会自动下载对应平台的 rr 二进制
• 运行 php artisan roadrunner:install，它会生成默认 .rr.yaml 和 rr.php
• rr.php 是关键：它调用 Laravel\Octane\RoadRunner\ServerProvider::server()，返回一个 Spiral\Goridge\RelayInterface 封装的 PSR-7 handler，不是传统 index.php

别手动改 public/index.php —— RoadRunner 不走这个文件；也别删 rr.php，它是启动入口。

.rr.yaml 最小必要配置项说明

默认生成的配置够跑 demo，但上线前必须检查这几项：

• http.address：设为 0.0.0.0:8080（别只写 :8080，否则可能只监听 localhost）
• http.pool.num_workers：建议设为 CPU 核心数 × 2（例如 4 核机器设 8），太少压不住并发，太多反而因上下文切换拖慢
• http.pool.supervisor.max_worker_lifetime：设为 0（永不重启）或一个大值（如 3600 秒），避免 worker 在处理长请求中途被杀
• rpc.listen：如果要用 rr get metrics 或健康检查，要开启（如 tcp://127.0.0.1:6001），否则 rr status 会连不上

注意：修改后必须 rr stop && rr serve 才生效，rr reload 对配置变更不一定可靠。

调试 worker 崩溃最有效的三件事

worker 退出时日志往往一闪而过，光看终端输出不够：

• 加 --debug 启动：rr serve --debug，会输出 goroutine trace 和更详细的 PHP 错误栈
• 把 PHP 错误重定向到文件：php -d log_errors=1 -d error_log=/var/log/rr-worker.log artisan octane:start（实际是 rr.php 启动的，所以要在 rr.php 里加 ini_set('error_log', '/path')）
• 检查 opcache.enable_cli=1 是否启用 —— RoadRunner 的 worker 是 CLI 模式运行，没开 opcache 会导致反复编译，内存暴涨后被 OOM kill

最容易被忽略的是：Laravel 的 APP_DEBUG=true 在 RoadRunner 下会暴露敏感路径和变量，且影响性能，上线前务必关掉，并确认 LOG_CHANNEL=stderr，让日志进 RoadRunner 的统一管道。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。