Roadrunner Bundle Laravel Package

Product Decisions This Supports

• Performance Optimization: Adopt a high-performance PHP application server (RoadRunner) to replace traditional PHP-FPM, reducing latency and improving scalability for Symfony applications.
• Microservices & API-First Roadmap: Enable seamless integration with async workers (e.g., queues, RPC) for event-driven architectures, aligning with a shift toward microservices.
• Build vs. Buy: Avoid reinventing a custom RoadRunner integration; leverage this bundle to standardize deployment across Symfony projects.
• Use Cases:
  • High-traffic Symfony APIs (e.g., e-commerce, SaaS platforms).
  • Long-running processes (e.g., CLI jobs, background tasks) via RoadRunner’s worker pools.
  • Observability-driven development (metrics, kernel reboots) to debug stateful services.

When to Consider This Package

• Adopt if:
  • Your Symfony app requires sub-100ms response times under heavy load (RoadRunner outperforms PHP-FPM).
  • You need async workers (e.g., queues, RPC) without external services like RabbitMQ.
  • Your stack includes stateful services (e.g., Doctrine, sessions) requiring kernel reboots or connection handling.
  • You prioritize developer experience (e.g., auto-reload in dev mode, metrics integration).
• Look elsewhere if:
  • Your app is low-traffic (overhead of RoadRunner may not justify gains).
  • You’re locked into PHP-FPM due to legacy infrastructure or hosting constraints.
  • You need Windows support (RoadRunner is Go-based; Windows compatibility is limited).
  • Your team lacks Go/Golang familiarity for debugging RoadRunner-specific issues.

How to Pitch It (Stakeholders)

Executives: "This bundle lets us deploy Symfony apps with RoadRunner, a Go-powered server that cuts response times by 30–50% vs. PHP-FPM. It’s battle-tested for high-scale APIs (e.g., Spatie), integrates seamlessly with our existing stack, and future-proofs us for async workloads. The MIT license and active maintenance (1.3.x updates) make it a low-risk upgrade."

Engineering: *"RoadRunner replaces PHP-FPM with a process manager + load balancer, handling:

• Kernel reboots on errors (prevents state corruption).
• Metrics (e.g., track request latency via Prometheus).
• Dev mode (auto-reload PHP files without restarts).
• Doctrine/session fixes (avoids DB connection leaks). We drop in a Symfony bundle, configure .rr.yaml, and gain async workers for free. Tradeoff: Docker images grow ~50MB (Go binary), but performance wins outweigh this."*

DevOps: *"Deployment simplifies to:

1. Add composer require andrey_mireichyk/roadrunner-bundle.
2. Copy .rr.* configs.
3. Run bin/rr serve (no PHP-FPM tuning needed). Docker support is built-in, and the bundle handles graceful restarts during deployments. Metrics expose unix://var/roadrunner_rpc.sock for monitoring."*