thecodingmachine/symfony-psr15-bridge

A bridge between Symfony middlewares (StackPHP) and compliant middleware for converting Symfony Http abstractions to PSR-15 and back.

thecodingmachine/symfony-psr15-bridge

Bridges between Symfony HttpKernel (a.k.a. StackPHP Middleware) and PSR-15 middlewares., _(*1)

, _(*2)

Those adapters are built on top of the existing symfony/psr-http-message-bridge that bridges Symfony and PSR-7 HTTP messages., _(*3)

Installation

The recommended way to install symfony-psr15-bridge is through Composer:, _(*4)

composer require thecodingmachine/symfony-psr15-bridge

Usage

By default, the Symfony HttpFoundation and HttpKernel are used. For PSR-7, the Zend-Diactoros implementation is used. These implementations can be changed if needed., _(*5)

Wrapping a HttpKernel

<?php

// Use the Psr15ToSymfonyBridge adapter
$psr15Middleware = new Psr15ToSymfonyBridge($yourHttpKernel);

// Handling PSR-7 requests
$psr7Response = $psr15Middleware->process($psr7Request, $dummyNextPsr7Middleware);

Important: Symfony Http Kernels do not have the notion of "next" middlewares. Therefore, the "next" PSR-7 middleware you pass to the process method will never be called., _(*6)

Wrapping a PSR-7 callback

<?php

// Use the Psr15ToSymfonyBridge adapter
$symfonyKernel = new SymfonyToPsr15Bridge($nextSymfonyMiddleware, $yourPsr15Middleware);

// Handling Symfony requests
$symfonyResponse = $symfonyKernel->handle($symfonyRequest);

Note: the adapter's constructor takes 2 middlewares: the "next" Symfony middleware that will be called by the "delegate" psr15 feature and the psr15 middleware to be wrapped., _(*7)

Other known middleware adapters

I initially planned to submit this project as a PR to h4cc/stack-psr7-bridge (that was developed before the notion of "PSR-7 middleware" was standardized in http-interop that was itself the precursor to PSR-15). I soon realized that this was in fact a complete rewrite so I decided to create a new project for it., _(*8)