/roadrunner-docs

RoadRunner documentation

Primary LanguagePHPMIT LicenseMIT

All releases

Join our discord server: Link

RoadRunner is an open-source (MIT licensed) high-performance PHP application server and 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 and is designed to replace traditional Nginx+FPM setups with enhanced performance and versatility. With its wide range of features, RoadRunner is a production-ready solution that is PCI DSS compliant, ensuring the security and safety of your web applications.

RoadRunner includes PSR-7, PSR-17 compatible HTTP and HTTP(S)/2/3/fCGI servers and can be used to replace classic Nginx+FPM setups with much greater performance and flexibility. HTTP(S)/2/3/fCGI servers as just one of its many available plugins, but its capabilities extend far beyond:

  • Queue drivers: RabbitMQ, Kafka, SQS, Beanstalk, NATS, In-Memory.
  • KV drivers: Redis, Memcached, BoltDB, In-Memory.
  • OpenTelemetry protocol support (gRPC, http, jaeger).
  • Workflows engine via Temporal
  • gRPC server. For increased speed, the protobuf extension can be used.
  • HTTP(S)/2/3 and fCGI server 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 server.
  • Systemd-like services manager with auto-restarts, execution time limiter, etc.
  • Embedded supervisor for your PHP workers with execution, max working time, and memory TTLs.
  • Compatible with Windows, WSL2, FreeBSD, GNU/Linux, etc.
  • And more 😉

If you have a feature request in mind, you can check out GitHub issues page. Here you'll find a list of open feature requests. The RoadRunner community is active and responsive, so feel free to join the discussion on our Discord channel or contribute to the project.

With the support of the community, RoadRunner will continue to grow and evolve to meet the needs of modern web development.

Useful articles