roadrunner Docker 镜像下载 - 轩辕镜像

RoadRunner 镜像文档

概述与主要用途

RoadRunner 是一款开源（MIT许可）的高性能PHP应用服务器、负载均衡器和进程管理器。它支持作为服务运行，并可根据项目需求扩展功能。作为PSR-7/PSR-17兼容的HTTP和HTTP/2服务器，RoadRunner能够替代传统的Nginx+FPM架构，提供显著提升的性能和更强的灵活性。

核心功能与特性

• 生产就绪：适合直接部署到生产环境
• PCI DSS合规：满足数据安全标准
• PSR-7 HTTP服务器：支持文件上传、错误处理、静态文件服务、热重载、中间件和事件监听器
• HTTPS与HTTP/2支持：包括HTTP/2推送、H2C（明文HTTP/2）
• 高度可定制服务器：支持FastCGI协议
• 灵活的环境配置：适应不同部署场景
• 无外部PHP依赖：仅需64位PHP环境，基于Goridge实现无缝集成
• 集成负载均衡、进程管理和任务管道：一站式服务治理
• 内置监控指标：支持Prometheus
• Temporal工作流引擎：通过Temporal.io SDK实现复杂工作流
• 多传输方式：支持TCP、UNIX套接字和标准管道
• 自动Worker管理：包括Worker替换和安全销毁PHP进程
• 精细的Worker控制：支持创建/分配/销毁超时设置、单Worker最大任务数
• 全面的Worker生命周期管理：
  • maxMemory：内存限制（优雅停止）
  • TTL：生存时间（优雅停止）
  • idleTTL：空闲时间（优雅停止）
  • execTTL：执行超时（强制停止，类似max_execution_time）
• Payload上下文与主体支持：丰富的数据传输能力
• 多层级错误管理：协议、Worker和任务级错误处理（含PHP错误）
• 开发模式：支持文件变更自动重载
• 多框架集成：与Symfony、Laravel、Slim、CakePHP、Zend Expressive等兼容
• Spiral框架应用服务器：原生支持Spiral框架
• Laravel Octane集成：包含在Laravel Octane中
• 跨平台支持：可在Windows运行（Windows 10支持UNIX套接字AF_UNIX）

安装方法

通过Composer安装

bash
$ composer require roadrunner-server/roadrunner:v2.0 nyholm/psr7
$ ./vendor/bin/rr get-binary

通过Docker镜像获取

可使用***Docker镜像：spiralscout/roadrunner:X.X.X（请将X.X.X替换为具体版本号）。更多镜像信息和标签可在Docker Hub查看。

配置说明

配置文件通常位于.rr.yaml（完整示例）：

yaml
rpc:
  listen: tcp://127.0.0.1:6001  # RPC服务监听地址

server:
  command: "php worker.php"  # 启动PHP Worker的命令

http:
  address: "0.0.0.0:8080"  # HTTP服务监听地址

logs:
  level: error  # 日志级别

示例Worker

以下是一个简单的PHP Worker示例：

php
<?php

use Spiral\RoadRunner;
use Nyholm\Psr7;

include "vendor/autoload.php";

// 创建Worker实例
$worker = RoadRunner\Worker::create();
$psrFactory = new Psr7\Factory\Psr17Factory();

// 创建PSR-7兼容的Worker
$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);
    }
}

运行方法

启动应用服务器：

bash
$ ./rr serve

许可证

RoadRunner基于MIT许可证开源。详情请查看LICENSE文件。由Spiral Scout维护。

更多详细信息请访问***文档。