Windows环境下RoadRunner安装与配置教程

你是否在Windows环境中寻找高性能的PHP应用服务器解决方案？RoadRunner作为一款由Go语言编写的高性能PHP应用服务器和进程管理器，能有效替代传统的Nginx+FPM架构。本文将详细介绍在Windows系统中安装、配置和运行RoadRunner的完整流程，让你快速掌握这一工具的使用方法。读完本文后，你将能够：在Windows系统中正确安装RoadRunner、配置基本服务参数、创建简单的PHP工作器、测试服务运行状态以及解决常见问题。

安装前准备

在开始安装RoadRunner前，需要确保系统满足以下要求：

• Windows 10或Windows Server 2019及以上版本
• PHP 7.4或更高版本（推荐PHP 8.0+）
• PHP扩展：php-curl、php-zip和php-sockets
• 管理员权限（用于安装系统服务）

检查PHP扩展是否已安装：

php --modules | findstr "curl zip sockets"

若显示以上三个扩展名称，则说明已满足基本要求。如未安装，需在php.ini中启用相应扩展或重新编译PHP。

安装方法

方法一：使用Chocolatey包管理器

Chocolatey是Windows系统下的包管理工具，通过以下命令可快速安装RoadRunner：

choco install roadrunner

安装完成后，验证安装是否成功：

rr --version

若显示版本信息，则说明安装成功。此方法适用于希望通过包管理器自动处理依赖和更新的用户。

方法二：手动下载二进制文件

1. 访问RoadRunner的GitCode仓库：https://gitcode.com/gh_mirrors/ro/roadrunner
2. 导航至"Releases"页面，下载适用于Windows的最新版本压缩包（通常命名为roadrunner-<version>-windows-amd64.zip）
3. 解压压缩包，将rr.exe文件复制到系统PATH环境变量中的任意目录（如C:\Windows\System32）或项目目录中

方法三：通过Composer安装

对于PHP项目，可通过Composer集成RoadRunner：

composer require spiral/roadrunner-cli
./vendor/bin/rr get-binary

此方法会将RoadRunner二进制文件下载到项目根目录，适用于项目级别的安装需求。相关代码实现可参考composer.json文件。

配置文件设置

RoadRunner使用YAML格式的配置文件，默认名称为.rr.yaml。创建基本配置文件：

version: '3'

rpc:
  listen: tcp://127.0.0.1:6001

server:
  command: "php worker.php"

http:
  address: "0.0.0.0:8080"

logs:
  level: error

配置文件主要包含以下几个部分：

• rpc: 远程过程调用配置，用于插件间通信
• server: PHP工作器配置，指定工作器文件路径
• http: HTTP服务配置，包括监听地址和端口
• logs: 日志级别配置，可选值：debug、info、warn、error

完整的配置示例可参考项目仓库中的配置文件模板。

创建PHP工作器

创建worker.php文件，作为PHP应用的入口点：

<?php

use Spiral\RoadRunner;
use Nyholm\Psr7;

include "vendor/autoload.php";

$worker = RoadRunner\Worker::create();
$psrFactory = new Psr7\Factory\Psr17Factory();

$worker = new RoadRunner\Http\PSR7Worker($worker, $psrFactory, $psrFactory, $psrFactory);

while ($req = $worker->waitRequest()) {
    try {
        $rsp = new Psr7\Response();
        $rsp->getBody()->write('Hello world!');

        $worker->respond($rsp);
    } catch (\Throwable $e) {
        $worker->getWorker()->error((string)$e);
    }
}

此工作器实现了基本的HTTP请求处理逻辑，遵循PSR-7标准。工作器通过循环等待并处理请求，实现了长进程运行模式，避免了传统PHP-FPM的进程创建销毁开销。

运行与管理服务

基本运行命令

在项目目录中执行以下命令启动RoadRunner服务：

rr serve -c .rr.yaml

Windows系统特有的服务启动逻辑在internal/cli/serve/command_windows.go文件中实现，处理了Windows平台下的信号处理和服务管理。

作为Windows服务运行

使用以下命令将RoadRunner安装为Windows服务：

rr service install -c .rr.yaml

相关服务管理命令：

• 启动服务：rr service start
• 停止服务：rr service stop
• 重启服务：rr service restart
• 卸载服务：rr service uninstall

测试服务运行

服务启动后，可通过以下方式测试是否正常运行：

1. 使用浏览器访问：http://localhost:8080，应显示"Hello world!"
2. 使用curl命令测试：

curl http://localhost:8080

若服务未正常启动，可检查以下几点：

• 确保PHP工作器文件路径正确
• 检查端口是否被占用
• 查看日志文件了解错误详情

常见问题解决

端口占用问题

若启动时提示"address already in use"，说明端口被占用，可通过以下命令查找占用进程：

netstat -ano | findstr :8080

然后结束相应进程或修改配置文件中的端口号。

PHP扩展缺失

若运行时提示缺少扩展，可通过以下命令安装所需依赖：

composer require nyholm/psr7 spiral/roadrunner

服务无法启动

检查配置文件格式是否正确，可使用YAML验证工具进行验证。同时确保PHP可执行文件路径已添加到系统PATH环境变量中。

总结与进阶

通过本文的步骤，你已成功在Windows环境中安装并配置了RoadRunner。RoadRunner作为高性能的PHP应用服务器，能够显著提升PHP应用的并发处理能力和响应速度。

进阶学习建议：

1. 探索更多插件功能，如队列系统、缓存等
2. 学习配置HTTPS支持，提升服务安全性
3. 了解性能调优参数，根据应用需求进行优化
4. 研究分布式部署方案，实现高可用架构

要获取更多关于RoadRunner的详细信息，可以查阅项目的官方文档和源代码。参与社区讨论和贡献，也是提升使用体验的有效途径。