{"id":13416755,"url":"https://github.com/roadrunner-server/roadrunner","last_synced_at":"2026-02-19T16:07:04.935Z","repository":{"id":37030712,"uuid":"115436884","full_name":"roadrunner-server/roadrunner","owner":"roadrunner-server","description":"🤯 High-performance PHP application server, process manager written in Go and powered with plugins","archived":false,"fork":false,"pushed_at":"2025-05-12T22:21:48.000Z","size":74388,"stargazers_count":8123,"open_issues_count":75,"forks_count":415,"subscribers_count":142,"default_branch":"master","last_synced_at":"2025-05-13T11:05:20.705Z","etag":null,"topics":["application-server","golang","hacktoberfest","http","php","psr-7","roadrunner","rpc","supervisor","workers"],"latest_commit_sha":null,"homepage":"https://docs.roadrunner.dev","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roadrunner-server.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":"roadrunner-server"}},"created_at":"2017-12-26T16:13:10.000Z","updated_at":"2025-05-12T19:59:18.000Z","dependencies_parsed_at":"2024-01-04T17:41:20.139Z","dependency_job_id":"aa39f03a-f092-4236-b473-5f7f7e4390cb","html_url":"https://github.com/roadrunner-server/roadrunner","commit_stats":{"total_commits":2841,"total_committers":59,"mean_commits":"48.152542372881356","dds":0.6304118268215417,"last_synced_commit":"91642b8522fc60bbb8ce6dddea9df3e6a324b2f6"},"previous_names":["spiral/roadrunner"],"tags_count":279,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roadrunner-server%2Froadrunner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roadrunner-server%2Froadrunner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roadrunner-server%2Froadrunner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roadrunner-server%2Froadrunner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roadrunner-server","download_url":"https://codeload.github.com/roadrunner-server/roadrunner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253929362,"owners_count":21985802,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["application-server","golang","hacktoberfest","http","php","psr-7","roadrunner","rpc","supervisor","workers"],"created_at":"2024-07-30T22:00:21.491Z","updated_at":"2025-05-13T11:05:44.191Z","avatar_url":"https://github.com/roadrunner-server.png","language":"Go","readme":"\u003ca href=\"https://roadrunner.dev\" target=\"_blank\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://github.com/roadrunner-server/.github/assets/8040338/e6bde856-4ec6-4a52-bd5b-bfe78736c1ff\"\u003e\n    \u003cimg align=\"center\" src=\"https://github.com/roadrunner-server/.github/assets/8040338/040fb694-1dd3-4865-9d29-8e0748c2c8b8\"\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n\u003cp align=\"center\"\u003e\n \u003ca href=\"https://packagist.org/packages/spiral/roadrunner\"\u003e\u003cimg src=\"https://poser.pugx.org/spiral/roadrunner/version\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://pkg.go.dev/github.com/roadrunner-server/roadrunner/v2025?tab=doc\"\u003e\u003cimg src=\"https://godoc.org/github.com/roadrunner-server/roadrunner/v2025?status.svg\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://twitter.com/spiralphp\"\u003e\u003cimg src=\"https://img.shields.io/twitter/follow/spiralphp?style=social\"\u003e\u003c/a\u003e\n    \u003ca href=\"https://codecov.io/gh/roadrunner-server/roadrunner/\"\u003e\u003cimg src=\"https://codecov.io/gh/roadrunner-server/roadrunner/branch/master/graph/badge.svg\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://github.com/roadrunner-server/roadrunner/actions\"\u003e\u003cimg src=\"https://github.com/roadrunner-server/roadrunner/workflows/rr_cli_tests/badge.svg\" alt=\"\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://goreportcard.com/report/github.com/roadrunner-server/roadrunner/v2\"\u003e\u003cimg src=\"https://goreportcard.com/badge/github.com/roadrunner-server/roadrunner/v2\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://discord.gg/TFeEmCs\"\u003e\u003cimg src=\"https://img.shields.io/badge/discord-chat-magenta.svg\"\u003e\u003c/a\u003e\n\t\u003ca href=\"https://packagist.org/packages/spiral/roadrunner\"\u003e\u003cimg src=\"https://img.shields.io/packagist/dd/spiral/roadrunner?style=flat-square\"\u003e\u003c/a\u003e\n    \u003cimg alt=\"All releases\" src=\"https://img.shields.io/github/downloads/roadrunner-server/roadrunner/total\"\u003e\n  \u003ca href=\"https://gurubase.io/g/roadrunner\"\u003e\u003cimg src=\"https://img.shields.io/badge/Gurubase-Ask%20RoadRunner%20Guru-006BFF?style=flat-square\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\nRoadRunner is an open-source (MIT licensed) high-performance PHP application server, process manager written in Go and powered with plugins ❤️.\nIt supports running as a service with the ability to extend its functionality on a per-project basis with plugins.\n\n\n# Features\n\n**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:\n- Queue drivers: RabbitMQ, Kafka, SQS, Beanstalk, NATS, In-Memory.\n- KV drivers: Redis, Memcached, BoltDB, In-Memory.\n- OpenTelemetry protocol support (`gRPC`, `http`, `jaeger`).\n- [Workflow engine](https://github.com/temporalio/sdk-php) via [Temporal](https://temporal.io).\n- `gRPC` server. For increased speed, the `protobuf` extension can be used.\n- `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.\n- Embedded distribute lock plugin which manages access to shared resources.\n- Metrics server (you might easily expose your own).\n- WebSockets and Broadcast via [Centrifugo](https://centrifugal.dev) server.\n- Systemd-like services manager with auto-restarts, execution time limiter, etc.\n- Production-ready.\n- And more 😉\n\n# Join our discord server: [Link](https://discord.gg/TFeEmCs)\n\n\u003cp align=\"center\"\u003e\n\t\u003ca href=\"https://roadrunner.dev/\"\u003e\u003cb\u003eOfficial Website\u003c/b\u003e\u003c/a\u003e |\n\t\u003ca href=\"https://docs.roadrunner.dev/\"\u003e\u003cb\u003eDocumentation\u003c/b\u003e\u003c/a\u003e |\n    \u003ca href=\"https://github.com/orgs/roadrunner-server/discussions\"\u003e\u003cb\u003eForum\u003c/b\u003e\u003c/a\u003e |\n    \u003ca href=\"https://github.com/orgs/roadrunner-server/projects/4\"\u003e\u003cb\u003eRelease schedule\u003c/b\u003e\u003c/a\u003e |\n    \u003ca href=\"https://gurubase.io/g/roadrunner\"\u003e\u003cb\u003eAsk RoadRunner Guru\u003c/b\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n# Installation\n\nThe easiest way to get the latest RoadRunner version is to use one of the pre-built release binaries, which are available for\nOSX, Linux, FreeBSD, and Windows. Instructions for using these binaries are on the GitHub [releases page](https://github.com/roadrunner-server/roadrunner/releases).\n\n## Docker:\n\nTo get the roadrunner binary file you can use our docker image: `ghcr.io/roadrunner-server/roadrunner:2025.X.X` (more information about\nimage and tags can be found [here](https://github.com/roadrunner-server/roadrunner/pkgs/container/roadrunner)).\n\n```dockerfile\nFROM ghcr.io/roadrunner-server/roadrunner:2025.X.X AS roadrunner\nFROM php:8.3-cli\n\nCOPY --from=roadrunner /usr/bin/rr /usr/local/bin/rr\n\n# USE THE RR\n```\n\nConfiguration located in the `.rr.yaml` file ([full sample](https://github.com/roadrunner-server/roadrunner/blob/master/.rr.yaml)):\n\n\n## Installation via Composer\nYou can also install RoadRunner automatically using the command shipped with the composer package, run:\n\n```bash\ncomposer require spiral/roadrunner-cli\n./vendor/bin/rr get-binary\n```\n\nServer binary will be available at the root of your project.\n\n\u003e **Note**\n\u003e\n\u003e PHP's extensions `php-curl` and `php-zip` are required to download RoadRunner automatically.\n\u003e PHP's extensions `php-sockets` need to be installed to run roadrunner.\n\u003e Check with `php --modules` your installed extensions.\n\n\n## Installation option for the Debian-derivatives (Ubuntu, Mint, MX, etc)\n\n```bash\nwget https://github.com/roadrunner-server/roadrunner/releases/download/v2025.X.X/roadrunner-2025.X.X-linux-amd64.deb\nsudo dpkg -i roadrunner-2025.X.X-linux-amd64.deb\n```\n\n## Download the latest release via curl:\n```bash\ncurl --proto '=https' --tlsv1.2 -sSf  https://raw.githubusercontent.com/roadrunner-server/roadrunner/master/download-latest.sh | sh\n```\n\n## MacOS using [Homebrew](https://brew.sh/):\n```bash\nbrew install roadrunner\n```\n\n## Windows using [Chocolatey](https://community.chocolatey.org/):\n```bash\nchoco install roadrunner\n```\n\n---\n\nConfiguration can be located in `.rr.yaml` file ([full sample](https://github.com/roadrunner-server/roadrunner/blob/master/.rr.yaml)):\n\n```yaml\nversion: '3'\n\nrpc:\n  listen: tcp://127.0.0.1:6001\n\nserver:\n  command: \"php worker.php\"\n\nhttp:\n  address: \"0.0.0.0:8080\"\n\nlogs:\n  level: error\n```\n\n\u003e Read more in [Documentation](https://docs.roadrunner.dev).\n\nExample Worker:\n--------\n\n```php\n\u003c?php\n\nuse Spiral\\RoadRunner;\nuse Nyholm\\Psr7;\n\ninclude \"vendor/autoload.php\";\n\n$worker = RoadRunner\\Worker::create();\n$psrFactory = new Psr7\\Factory\\Psr17Factory();\n\n$worker = new RoadRunner\\Http\\PSR7Worker($worker, $psrFactory, $psrFactory, $psrFactory);\n\nwhile ($req = $worker-\u003ewaitRequest()) {\n    try {\n        $rsp = new Psr7\\Response();\n        $rsp-\u003egetBody()-\u003ewrite('Hello world!');\n\n        $worker-\u003erespond($rsp);\n    } catch (\\Throwable $e) {\n        $worker-\u003egetWorker()-\u003eerror((string)$e);\n    }\n}\n```\n\n\u003e [!IMPORTANT]\n\u003e If you see the `EOF` error, check that you have installed the PHP packages from [this step](https://github.com/roadrunner-server/roadrunner#installation-via-composer).\n\u003e If this does not help, try to execute the command `php worker.php` directly and check the output.\n\n---\n\n### Available Plugins: [link](https://docs.roadrunner.dev)\n\nRun:\n----\nTo run application server:\n\n```\n$ ./rr serve -c .rr.yaml\n```\n\nLicense:\n--------\nThe MIT License (MIT). Please see [`LICENSE`](./LICENSE) for more information. Maintained\nby [Spiral Scout](https://spiralscout.com).\n\n## Contributors\n\nThanks to all the people who already contributed!\n\n\u003ca href=\"https://github.com/roadrunner-server/roadrunner/graphs/contributors\"\u003e\n  \u003cimg src=\"https://contributors-img.web.app/image?repo=roadrunner-server/roadrunner\" /\u003e\n\u003c/a\u003e\n","funding_links":["https://github.com/sponsors/roadrunner-server"],"categories":["Popular","Go","PHP","配置 Configuration","Configuration","后端开发框架及项目","php","武器库","Server Applications","Table of Contents","Relational Databases","Alternative PHP Servers"],"sub_categories":["Libraries","基础设施 Infrastructure","Infrastructure","PHP开发","后端","HTTP Clients","Alternative PHP Servers","News"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froadrunner-server%2Froadrunner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froadrunner-server%2Froadrunner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froadrunner-server%2Froadrunner/lists"}