zolex/reactphp-bundle

ReactPHP Bundle for Symfony

1.0.0 2025-07-04 12:28 UTC

Requires

• php: ^8.1
• ext-fileinfo: *
• nyholm/psr7: ^1.8
• psr/http-message: ^1.0
• psr/http-server-handler: ^1.0
• react/http: ^1.11
• symfony/config: ^6.4|^7.0
• symfony/dependency-injection: ^6.4|^7.0
• symfony/dotenv: ^6.4|^7.0
• symfony/http-kernel: ^6.4|^7.0
• symfony/psr-http-message-bridge: ^6.4|^7.0
• symfony/routing: ^6.4|^7.0
• symfony/runtime: ^6.4|^7.0

Requires (Dev)

• symfony/framework-bundle: ^6.4|^7.0

MIT

• Andreas Linden

README

A Symfony Bundle providing a Runtime for ReactPHP, a PSR-17 Kernel and a Router to serve assets.

Turn any Symfony project into a "self-serving" application, no traditional webserver required.

Installation

composer require zolex/reactphp-bundle

Start the server

APP_RUNTIME="Zolex\\ReactPhpBundle\\Runtime\\ReactPhpRuntime" php public/index.php

For a very basic docker example, check the Dockerfile in the docs folder.

Assets

To allow serving assets from the public directory through ReactPHP, add this file to your project config/routes/react_bundle.yaml

reactphp_bundle:
  type: reactphp_bundle
  resource: .

By default, only files in the public/bundles directory are served (like Swagger-UI in API-Platform). Additional directories and files can be registered in the bundle config at config/bundles/zolex_react_php.yaml:

zolex_react_php:
    asset_paths:
        - /bundles/
        - /custom-dir/
        - /single-file.js
        - /another/single/file.css