Roadrunner Bundle Laravel Package

Product Decisions This Supports

• Performance Optimization: Replace traditional PHP-FPM with RoadRunner to achieve lower latency, higher throughput, and reduced memory usage (critical for high-traffic APIs or microservices).
• Roadmap Alignment: Adopt a build vs. buy decision to leverage RoadRunner’s gRPC, KV caching, and metrics capabilities without reinventing infrastructure.
• Use Cases:
  • Real-time APIs (WebSockets, gRPC) via RoadRunner’s built-in support.
  • Long-running processes (e.g., background jobs) with kernel reboot strategies to prevent memory leaks.
  • Observability via Prometheus metrics and Sentry integration.
  • Multi-protocol apps (HTTP + gRPC) without duplicating infrastructure.

When to Consider This Package

• Adopt if:

  • Your Symfony app is I/O-bound (e.g., APIs with DB/network calls) and needs sub-100ms response times.
  • You require gRPC, KV caching, or metrics without third-party services (e.g., Redis for caching).
  • Your team is already using RoadRunner in other services (consistency).
  • You need fine-grained kernel reboot control (e.g., stateful services with ResetInterface).

• Look elsewhere if:

  • Your app is CPU-bound (RoadRunner excels at I/O, not parallel CPU tasks).
  • You’re not using Symfony (this bundle is Symfony-specific).
  • Your infrastructure already uses PHP-FPM with no performance bottlenecks.
  • You lack Golang/DevOps expertise (RoadRunner requires rr binary management).

How to Pitch It (Stakeholders)

For Executives: "This bundle lets us replace PHP-FPM with RoadRunner—a Golang-powered PHP server that cuts latency by 30–50% and scales horizontally with zero code changes. It’s battle-tested by Spiral Framework and adds gRPC, caching, and metrics out-of-the-box. For our [X] API, this means lower cloud costs and faster feature delivery without rewriting infrastructure."

For Engineering: *"RoadRunner gives us:

• Performance: Async I/O (no PHP-FPM overhead).
• Extensibility: gRPC, KV caching, and Prometheus metrics via config.
• Reliability: Kernel reboot strategies to handle memory leaks/exceptions.
• Symfony Native: No PSR-15 middleware hacks—just Symfony requests/responses. Tradeoff: We’ll need to manage the rr binary (Dockerfile example provided)."*