English spoken conference

You are browsing the Symfony 5.0 documentation, which changes significantly from Symfony 3.x. If your app doesn't use Symfony 5.0 yet, browse the Symfony 3.4 documentation.

The PSR-7 Bridge

5.0 version
Maintained Unmaintained

The PSR-7 Bridge

The PSR-7 bridge converts HttpFoundation objects from and to objects implementing HTTP message interfaces defined by the PSR-7.

Installation

1
$ composer require symfony/psr-http-message-bridge

Note

If you install this component outside of a Symfony application, you must require the vendor/autoload.php file in your code to enable the class autoloading mechanism provided by Composer. Read this article for more details.

The bridge also needs a PSR-7 and PSR-17 implementation to convert HttpFoundation objects to PSR-7 objects. The following command installs the nyholm/psr7 library, a lightweight and fast PSR-7 implementation, but you can use any of the libraries that implement psr/http-factory-implementation:

1
$ composer require nyholm/psr7

Usage

Converting from HttpFoundation Objects to PSR-7

The bridge provides an interface of a factory called HttpMessageFactoryInterface that builds objects implementing PSR-7 interfaces from HttpFoundation objects.

The following code snippet explains how to convert a Request to a Nyholm\Psr7\ServerRequest class implementing the Psr\Http\Message\ServerRequestInterface interface:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
use Nyholm\Psr7\Factory\Psr17Factory;
use Symfony\Bridge\PsrHttpMessage\Factory\PsrHttpFactory;
use Symfony\Component\HttpFoundation\Request;

$symfonyRequest = new Request([], [], [], [], [], ['HTTP_HOST' => 'dunglas.fr'], 'Content');
// The HTTP_HOST server key must be set to avoid an unexpected error

$psr17Factory = new Psr17Factory();
$psrHttpFactory = new PsrHttpFactory($psr17Factory, $psr17Factory, $psr17Factory, $psr17Factory);
$psrRequest = $psrHttpFactory->createRequest($symfonyRequest);

And now from a Response to a Nyholm\Psr7\Response class implementing the Psr\Http\Message\ResponseInterface interface:

1
2
3
4
5
6
7
8
9
use Nyholm\Psr7\Factory\Psr17Factory;
use Symfony\Bridge\PsrHttpMessage\Factory\PsrHttpFactory;
use Symfony\Component\HttpFoundation\Response;

$symfonyResponse = new Response('Content');

$psr17Factory = new Psr17Factory();
$psrHttpFactory = new PsrHttpFactory($psr17Factory, $psr17Factory, $psr17Factory, $psr17Factory);
$psrResponse = $psrHttpFactory->createResponse($symfonyResponse);

Converting Objects implementing PSR-7 Interfaces to HttpFoundation

On the other hand, the bridge provide a factory interface called HttpFoundationFactoryInterface that builds HttpFoundation objects from objects implementing PSR-7 interfaces.

The next snippet explain how to convert an object implementing the Psr\Http\Message\ServerRequestInterface interface to a Request instance:

1
2
3
4
5
6
use Symfony\Bridge\PsrHttpMessage\Factory\HttpFoundationFactory;

// $psrRequest is an instance of Psr\Http\Message\ServerRequestInterface

$httpFoundationFactory = new HttpFoundationFactory();
$symfonyRequest = $httpFoundationFactory->createRequest($psrRequest);

From an object implementing the Psr\Http\Message\ResponseInterface to a Response instance:

1
2
3
4
5
6
use Symfony\Bridge\PsrHttpMessage\Factory\HttpFoundationFactory;

// $psrResponse is an instance of Psr\Http\Message\ResponseInterface

$httpFoundationFactory = new HttpFoundationFactory();
$symfonyResponse = $httpFoundationFactory->createResponse($psrResponse);

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.