spiral/roadrunner-worker

RoadRunner: PHP worker

v3.6.2 2025-05-05 12:34 UTC

Requires

• php: >=8.1
• composer-runtime-api: ^2.0
• ext-json: *
• ext-sockets: *
• psr/log: ^2.0 || ^3.0
• spiral/goridge: ^4.1.0
• spiral/roadrunner: ^2023.1 || ^2024.1 || ^2025.1

Requires (Dev)

• buggregator/trap: ^1.13
• jetbrains/phpstorm-attributes: ^1.0
• phpunit/phpunit: ^10.5.45
• spiral/code-style: ^2.2
• vimeo/psalm: ^6.0

Suggests

• spiral/roadrunner-cli: Provides RoadRunner installation and management CLI tools

MIT

• Anton Titov (wolfy-j)
• Valery Piashchynski
• Aleksei Gagarin (roxblnfk)
• Pavel Buchnev (butschster)
• Maksim Smakouz (msmakouz)
• RoadRunner Community

README

RoadRunner is an open-source (MIT licensed) high-performance PHP application server, load balancer, and process manager. It supports running as a service with the ability to extend its functionality on a per-project basis.

RoadRunner includes PSR-7/PSR-17 compatible HTTP and HTTP/2 server and can be used to replace classic Nginx+FPM setup with much greater performance and flexibility.

Official Website | Documentation

Repository:

This repository contains the common codebase for all binary roadrunner workers. Check spiral/roadrunner to access application server and spiral/roadrunner-http for PSR-7 compatible worker.

You can use the convenient installer to download the latest available compatible version of RoadRunner assembly:

$ composer require spiral/roadrunner-cli --dev

To download latest version of application server:

$ vendor/bin/rr get

Example:

To init abstract RoadRunner worker:

<?php

require __DIR__ . '/vendor/autoload.php';

// Create a new Worker from global environment
$worker = \Spiral\RoadRunner\Worker::create();

while ($data = $worker->waitPayload()) {
    // Received Payload
    var_dump($data);

    // Respond Answer
    $worker->respond(new \Spiral\RoadRunner\Payload('DONE'));
}

Testing:

This codebase is automatically tested via host repository - spiral/roadrunner.

License:

The MIT License (MIT). Please see LICENSE for more information. Maintained by Spiral Scout.