正确配置 Composer 自动加载并在开发时启用 rr 的 watch 模式,可实现 RoadRunner 中的热重载。1. 在 Worker 脚本引入 vendor/autoload.php;2. 确保类遵循 PSR-4 并在 composer.json 声明;3. 开发环境使用 ./rr serve -d --watch 实现文件变更自动重启;4. 生产环境部署时运行 composer install --optimize-autoloader --no-dev 并手动重启服务以加载最新代码。

RoadRunner 是一个高性能的 PHP 应用服务器,支持长时间运行的 PHP 进程,与传统 FPM 模式不同。它通过 Worker 机制执行 PHP 代码,因此在使用 Composer 管理依赖时,需要特别注意自动加载机制和热重载(hot reload)的配置。下面介绍如何在 RoadRunner 项目中正确集成 Composer 并实现开发环境下的热重载。
Composer 自动加载与 RoadRunner 的协作
RoadRunner 启动后会加载一次 PHP Worker,该 Worker 会包含你的应用代码和 Composer 的自动加载器(autoload)。这意味着一旦 Worker 启动,它使用的类映射是固定的,除非重新启动 Worker,否则不会感知到新添加或修改的类文件。
为了确保 RoadRunner 能正确加载由 Composer 管理的类,你需要:
- 在项目根目录运行 composer install 或 composer update,生成 autoload.php 和类映射
- 在 RoadRunner 的 Worker 脚本中引入 Composer 的自动加载文件:require_once __DIR__ . '/vendor/autoload.php';
- 确保所有自定义类都遵循 PSR-4 或 PSR-0 规范,并已在 composer.json 中声明
开发环境中的热重载实现
RoadRunner 本身不提供文件变更监听和自动重启功能,但你可以通过以下方式在开发阶段实现“热重载”效果:
- 使用 rr 命令行工具的 --watch 参数(需安装 rr CLI)来监听文件变化并自动重启 Worker
- 在启动命令中加入: ./rr serve -d --watch,这将启用开发模式下的文件监听
- 确保 .rr.yaml 配置中启用了 internalWorkers.restartInterval 或使用 pool.numWorkers 控制进程生命周期
另一种方式是结合第三方工具如 inotifywait(Linux)或 nodemon(通过 node.js 包装),在检测到 PHP 文件变更时手动重启 RoadRunner 服务。
生产环境注意事项
在生产环境中,不应依赖文件监听机制。每次部署新代码时,应:
- 运行 composer install --optimize-autoloader --no-dev 生成高效的类映射
- 重启 RoadRunner 服务,使 Worker 重新加载最新的代码
- 避免在运行时动态修改已加载的类,PHP 的 OPCache 也可能影响类的更新
基本上就这些。只要正确配置 Composer 自动加载,并在开发时启用 rr 的 watch 模式,就能高效地在 RoadRunner 中进行 PHP 开发。热重载虽不如传统 FPM 那样“天然”,但通过工具链支持完全可以满足日常开发需求。










