roadrunner/http-bundle

Integration roadrunner http with symfony

dev-main 2025-10-11 21:53 UTC

Requires

• php: ^8.1
• spiral/roadrunner-http: ^v3.6
• symfony/dependency-injection: ^6.0|^7.0
• symfony/http-kernel: ^6.0|^7.0
• symfony/runtime: ^6.0|^7.0

Requires (Dev)

• amphp/file: ^3.2
• amphp/http-client: ^5.3
• codeception/codeception: ^5.2
• codeception/module-asserts: *
• codeception/module-phpbrowser: *
• codeception/module-rest: ^3.4
• doctrine/doctrine-bundle: ^2.10
• doctrine/orm: ^2.15
• friendsofphp/php-cs-fixer: 3.65.0
• internal/dload: ^1.6
• nyholm/symfony-bundle-test: ^3.0
• phpstan/extension-installer: ^1.4
• phpstan/phpstan: ^2.0
• phpstan/phpstan-symfony: ^2.0
• phpunit/phpunit: ^10.3
• salsify/json-streaming-parser: ^8.3
• sentry/sentry-symfony: ^4.10
• spiral-packages/profiler: ^1.2
• spiral/roadrunner: ^2025.1
• symfony/mime: ^6.0|^7.0
• symfony/monolog-bundle: ^3.8
• symfony/serializer: ^6.0|^7.0
• symfony/string: ^6.0|^7.0
• symfony/web-profiler-bundle: ^6.0|^7.0

MIT

• Vlad Shashkov
• RoadRunner Community

• symfony
• http
• bundle
• roadrunner

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