PHPackages                             spiral/roadrunner-http - 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. [HTTP & Networking](/categories/http)
4. /
5. spiral/roadrunner-http

ActiveLibrary[HTTP & Networking](/categories/http)

spiral/roadrunner-http
======================

RoadRunner: HTTP and PSR-7 worker

v4.1.0(2mo ago)799.2M—9.5%920MITPHPPHP >=8.1CI passing

Since Dec 16Pushed 2mo ago8 watchersCompare

[ Source](https://github.com/roadrunner-php/http)[ Packagist](https://packagist.org/packages/spiral/roadrunner-http)[ Docs](https://spiral.dev/)[ GitHub Sponsors](https://github.com/sponsors/roadrunner-server)[ RSS](/packages/spiral-roadrunner-http/feed)WikiDiscussions 4.x Synced 1mo ago

READMEChangelog (10)Dependencies (26)Versions (25)Used By (20)

[   ![](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/ecabb342cac73cd0d73b259413ec78df5e4125e1e7f28f4b098d53efbfa5f982/68747470733a2f2f676f646f632e6f72672f6769746875622e636f6d2f73706972616c2f726f616472756e6e65723f7374617475732e737667)](https://pkg.go.dev/github.com/spiral/roadrunner?tab=doc) [![](https://github.com/spiral/roadrunner/workflows/CI/badge.svg)](https://github.com/spiral/roadrunner/actions) [![](https://camo.githubusercontent.com/3fd3ac7f6c0ae92218b9169d2c0ca83f309d88e9312ffbc33a7d073e039f4fad/68747470733a2f2f676f7265706f7274636172642e636f6d2f62616467652f6769746875622e636f6d2f73706972616c2f726f616472756e6e6572)](https://goreportcard.com/report/github.com/spiral/roadrunner) [![](https://camo.githubusercontent.com/417fb88829630bc2365f7a7cd444a91c50d8a238cf3453398a6c918430d21757/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f73706972616c2f726f616472756e6e65722f6261646765732f7175616c6974792d73636f72652e706e67)](https://scrutinizer-ci.com/g/spiral/roadrunner/?branch=master) [![](https://camo.githubusercontent.com/4442b73a11753b80fdd7b442ddbfaf8383902c8b9ffa66ed1718e8c62e102f2e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646973636f72642d636861742d6d6167656e74612e737667)](https://discord.gg/spiralphp) [![](https://camo.githubusercontent.com/c096285d6d4c067766e44f826140a981b5976a448c253fcd0218446a793e9ab2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64642f73706972616c2f726f616472756e6e65723f7374796c653d666c61742d737175617265)](https://packagist.org/packages/spiral/roadrunner)

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**](https://roadrunner.dev/) | [**Documentation**](https://docs.roadrunner.dev)

Repository:
-----------

[](#repository)

This repository contains the codebase PSR-7 PHP workers. Check [spiral/roadrunner](https://github.com/spiral/roadrunner) to get application server.

Requirements:
-------------

[](#requirements)

Ensure that your server is configured with the following PHP versions and extensions:

- PHP >=8.1
- ext-protobuf: This extension is optional but **highly recommended for installation**. Without it, performance may be up to 50% lower.
- RoadRunner ^2023.3

Installation:
-------------

[](#installation)

To install application server and HTTP codebase:

```
composer require spiral/roadrunner-http nyholm/psr7
```

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
```

> You can use any [PSR-17 compatible implementation](https://packagist.org/providers/psr/http-factory-implementation).

Example:
--------

[](#example)

To init abstract RoadRunner worker:

```