README

RoadRunner is a high-performance PHP application server and process manager, designed with extensibility in mind through its utilization of plugins.

Features

• Middleware
• Supported streaming response
• Sentry: Push/pop scope (if the SentryBundle use)
• Doctrine: clear opened managers and check connection is still usable after each request ( if DoctrineBundle is use)

Requirements:

• php >= 8.1
• symfony >= 6.0

1. Connect recipes

See link recipies repository

1. Install package

composer req http

1. Configure:

• docker-compose-roadrunner.yml
• Dockerfile
• .rr.http.yaml
• config/packages/roadrunner.http.yaml

Sentry integrations

Install packages:

composer require sentry

If SentryBundle is use, the following parameters is available to you:

• useSentryIntegration - Connect integration

Example config:

Specific worker

road_runner_http:
  useSentryIntegration: true

Doctrine integrations

Install packages:

composer require orm

If DoctrineBundle is use, the following parameters is available to you:

• useDoctrineIntegration - Connect integration
• useLoggingDoctrineOpenTransaction - Connect middleware that report unclosed transaction to monolog
• useTrackingSentryDoctrineOpenTransaction - Connect middleware that report unclosed transaction to sentry

These parameters accept a list of entity-managers

Example config:

road_runner_http:
  useDoctrineIntegration:
    - default
    - test

  useLoggingDoctrineOpenTransaction:
    - default
    - test

  useTrackingSentryDoctrineOpenTransaction:
    - default

Streamed Response

The bundle supports the standard Symfony responses:

Symfony\Component\HttpFoundation\StreamedResponse
Symfony\Component\HttpFoundation\StreamedJsonResponse

It also provides its own optimized implementations:

Roadrunner\Integration\Symfony\Http\Bridge\HttpFoundation\StreamedResponse
Roadrunner\Integration\Symfony\Http\Bridge\HttpFoundation\StreamedJsonResponse

We recommend using the Roadrunner\Integration\Symfony implementations whenever possible, as they eliminate unnecessary I/O overhead and offer better performance in the RoadRunner environment.
At the same time, full backward compatibility with the standard Symfony responses is preserved, ensuring that third-party libraries built for Symfony\Component\HttpFoundation continue to work seamlessly.

Examples of use:

• Symfony\Component\HttpFoundation\StreamedResponse
• Roadrunner\Integration\Symfony\Http\Bridge\HttpFoundation\StreamedResponse
• Symfony\Component\HttpFoundation\StreamedJsonResponse
• Roadrunner\Integration\Symfony\Http\Bridge\HttpFoundation\StreamedJsonResponse