PHPackages spiral/roadrunner - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. spiral/roadrunner ActiveMetapackage[Framework](/categories/framework) spiral/roadrunner ================= RoadRunner: High-performance PHP application server and process manager written in Go and powered with plugins v2025.1.11(2mo ago)8.5k12.2M—4.2%423[83 issues](https://github.com/roadrunner-server/roadrunner/issues)20MITGoCI passing Since Jan 28Pushed 3d ago142 watchersCompare [ Source](https://github.com/roadrunner-server/roadrunner)[ Packagist](https://packagist.org/packages/spiral/roadrunner)[ Docs](https://roadrunner.dev/)[ GitHub Sponsors](https://github.com/sponsors/roadrunner-server)[ RSS](/packages/spiral-roadrunner/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)DependenciesVersions (271)Used By (20)Security (1) [ ![](https://github.com/roadrunner-server/.github/assets/8040338/040fb694-1dd3-4865-9d29-8e0748c2c8b8) ](https://roadrunner.dev) [![](https://camo.githubusercontent.com/c9bb46881cd9965bebb2932d205d46ce43a589efe9f133b9efb2aec664567be2/68747470733a2f2f706f7365722e707567782e6f72672f73706972616c2f726f616472756e6e65722f76657273696f6e)](https://packagist.org/packages/spiral/roadrunner) [![](https://camo.githubusercontent.com/c1fa8befe608990c2a207bd0c8ab00fcb24f441186a92f366b834c7aa0519f67/68747470733a2f2f676f646f632e6f72672f6769746875622e636f6d2f726f616472756e6e65722d7365727665722f726f616472756e6e65722f76323032353f7374617475732e737667)](https://pkg.go.dev/github.com/roadrunner-server/roadrunner/v2025?tab=doc) [![](https://camo.githubusercontent.com/e9f8bdc5fc20237f616f0907de1af7fa649ec2e793c3138bd39a097c9c8e0347/68747470733a2f2f696d672e736869656c64732e696f2f747769747465722f666f6c6c6f772f73706972616c7068703f7374796c653d736f6369616c)](https://twitter.com/spiralphp) [![](https://camo.githubusercontent.com/62c7f916e7fc730d1d92d58ae369f21e17a2c8794e0a8f3a8949c406ce8ae70e/68747470733a2f2f636f6465636f762e696f2f67682f726f616472756e6e65722d7365727665722f726f616472756e6e65722f6272616e63682f6d61737465722f67726170682f62616467652e737667)](https://codecov.io/gh/roadrunner-server/roadrunner/) [![](https://github.com/roadrunner-server/roadrunner/workflows/rr_cli_tests/badge.svg)](https://github.com/roadrunner-server/roadrunner/actions) [![](https://camo.githubusercontent.com/436778a42b1fabde6d72a326a11c3a5a623a5597fa8ed2846b8b06ab4d309628/68747470733a2f2f676f7265706f7274636172642e636f6d2f62616467652f6769746875622e636f6d2f726f616472756e6e65722d7365727665722f726f616472756e6e65722f7632)](https://goreportcard.com/report/github.com/roadrunner-server/roadrunner/v2) [![](https://camo.githubusercontent.com/4442b73a11753b80fdd7b442ddbfaf8383902c8b9ffa66ed1718e8c62e102f2e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646973636f72642d636861742d6d6167656e74612e737667)](https://discord.gg/TFeEmCs) [![](https://camo.githubusercontent.com/c096285d6d4c067766e44f826140a981b5976a448c253fcd0218446a793e9ab2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64642f73706972616c2f726f616472756e6e65723f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spiral/roadrunner) [![All releases](https://camo.githubusercontent.com/bc57ac59ba98124633812f212781e21b39a3541ad364b396b4fc74e5112704d9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f726f616472756e6e65722d7365727665722f726f616472756e6e65722f746f74616c)](https://camo.githubusercontent.com/bc57ac59ba98124633812f212781e21b39a3541ad364b396b4fc74e5112704d9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f646f776e6c6f6164732f726f616472756e6e65722d7365727665722f726f616472756e6e65722f746f74616c) [![](https://camo.githubusercontent.com/0387f05b5fa69becc644d136104bc2caad7a31de53652825ce323c0dc2414197/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f47757275626173652d41736b253230526f616452756e6e6572253230477572752d3030364246463f7374796c653d666c61742d737175617265)](https://gurubase.io/g/roadrunner) RoadRunner is an open-source (MIT licensed) high-performance PHP application server, process manager written in Go and powered with plugins ❤️. It supports running as a service with the ability to extend its functionality on a per-project basis with plugins. Features ======== [](#features) **RoadRunner** features a range of plugins, including `HTTP(S)/2/3` and `fCGI` servers that are compatible with PSR-7/PSR-17 standards. This is just one of its many capabilities. It serves as an effective alternative to the traditional Nginx+FPM setup, providing improved performance and more flexibility. Its extensive plugin options go far beyond just `HTTP(S)/2/3` and `fCGI` servers, offering a broad range of functionalities: - Queue drivers: RabbitMQ, Kafka, SQS, Beanstalk, NATS, In-Memory. - KV drivers: Redis, Memcached, BoltDB, In-Memory. - OpenTelemetry protocol support (`gRPC`, `http`, `jaeger`). - [Workflow engine](https://github.com/temporalio/sdk-php) via [Temporal](https://temporal.io). - `gRPC` server. For increased speed, the `protobuf` extension can be used. - `HTTP(S)/2/3` and `fCGI` servers features **automatic TLS management**, **103 Early Hints** support and middleware like: Static, Headers, gzip, prometheus (metrics), send (x-sendfile), OTEL, proxy\_ip\_parser, etc. - Embedded distribute lock plugin which manages access to shared resources. - Metrics server (you might easily expose your own). - WebSockets and Broadcast via [Centrifugo](https://centrifugal.dev) server. - Systemd-like services manager with auto-restarts, execution time limiter, etc. - Production-ready. - And more 😉 Join our discord server: [Link](https://discord.gg/TFeEmCs) =========================================================== [](#join-our-discord-server-link) [**Official Website**](https://roadrunner.dev/) | [**Documentation**](https://docs.roadrunner.dev/) | [**Forum**](https://github.com/orgs/roadrunner-server/discussions) | [**Release schedule**](https://github.com/orgs/roadrunner-server/projects/4) | [**Ask RoadRunner Guru**](https://gurubase.io/g/roadrunner) Installation ============ [](#installation) The easiest way to get the latest RoadRunner version is to use one of the pre-built release binaries, which are available for OSX, Linux, FreeBSD, and Windows. Instructions for using these binaries are on the GitHub [releases page](https://github.com/roadrunner-server/roadrunner/releases). Docker: ------- [](#docker) To get the roadrunner binary file you can use our docker image: `ghcr.io/roadrunner-server/roadrunner:2025.X.X` (more information about image and tags can be found [here](https://github.com/roadrunner-server/roadrunner/pkgs/container/roadrunner)). ``` FROM ghcr.io/roadrunner-server/roadrunner:2025.X.X AS roadrunner FROM php:8.3-cli COPY --from=roadrunner /usr/bin/rr /usr/local/bin/rr # USE THE RR ``` Configuration located in the `.rr.yaml` file ([full sample](https://github.com/roadrunner-server/roadrunner/blob/master/.rr.yaml)): Installation via Composer ------------------------- [](#installation-via-composer) You can also install RoadRunner automatically using the command shipped with the composer package, run: ``` composer require spiral/roadrunner-cli ./vendor/bin/rr get-binary ``` Server binary will be available at the root of your project. > **Note** > > PHP's extensions `php-curl` and `php-zip` are required to download RoadRunner automatically. PHP's extensions `php-sockets` need to be installed to run roadrunner. Check with `php --modules` your installed extensions. Installation option for the Debian-derivatives (Ubuntu, Mint, MX, etc) ---------------------------------------------------------------------- [](#installation-option-for-the-debian-derivatives-ubuntu-mint-mx-etc) ``` wget https://github.com/roadrunner-server/roadrunner/releases/download/v2025.X.X/roadrunner-2025.X.X-linux-amd64.deb sudo dpkg -i roadrunner-2025.X.X-linux-amd64.deb ``` Download the latest release via curl: ------------------------------------- [](#download-the-latest-release-via-curl) ``` curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/roadrunner-server/roadrunner/master/download-latest.sh | sh ``` MacOS using [Homebrew](https://brew.sh/): ----------------------------------------- [](#macos-using-homebrew) ``` brew install roadrunner ``` Windows using [Chocolatey](https://community.chocolatey.org/): -------------------------------------------------------------- [](#windows-using-chocolatey) ``` choco install roadrunner ``` --- Configuration can be located in `.rr.yaml` file ([full sample](https://github.com/roadrunner-server/roadrunner/blob/master/.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 ``` > Read more in [Documentation](https://docs.roadrunner.dev). Example Worker: --------------- [](#example-worker) ```