README

This bundle provides support for HTTP messages interfaces defined in PSR-7. It allows to inject instances of Psr\Http\Message\ServerRequestInterface and to return instances of Psr\Http\Message\ResponseInterface in controllers.

The inital code is borrowed from sensio/framework-extra-bundle which removed support for PSR-7 since version 6.0.

Installation

To install the latest stable version of this component, open a console and execute the following command:

$ composer require ajgarlag/psr-http-message-bundle

Note that autowiring aliases for PSR-17 must be installed. An easy way to provide them is to require nyholm/psr7 :

$ composer require nyholm/psr7

Configuration

If your code depends on old sensio_framework_extra_... services identifiers, you should enable aliasing defining:

ajgarlag_psr_http_message:
    alias_sensio_framework_extra_services:
        enabled: true

Usage

Then, PSR-7 messages can be used directly in controllers like in the following code snippet

namespace App\Controller;

use Psr\Http\Message\ResponseFactoryInterface;
use Psr\Http\Message\ServerRequestInterface;

class DefaultController
{
    public function index(ServerRequestInterface $request, ResponseFactoryInterface $responseFactory)
    {
        // Interact with the PSR-7 request

        $response = $responseFactory->createResponse();
        // Interact with the PSR-7 response

        return $response;
    }
}

Note that internally, Symfony always use Symfony\Component\HttpFoundation\Request and Symfony\Component\HttpFoundation\Response instances.

Upgrade path from sensio/framework-extra-bundle PSR-7 support

If your code depends on sensio/framework-extra-bundle PSR-7 support, this is the suggested upgrade path:

Require sensio/framework-extra-bundle:^5.3.
Require ajgarlag/psr-http-message-bundle:^1.1, and enable old services aliasing.
Disable PSR-7 support in sensio_framework_extra configuration.
If your code depends on old sensio_framework_extra.psr7.http_(message|foundation)_factory services identifiers, modify service definitions to use the Symfony\Bridge\PsrHttpMessage\Http(Message|Foundation)Interface alternatives following deprecation messages.
Do you need any other feature provided by sensio/framework-extra-bundle?:
- YES: require sensio/framework-extra-bundle:^6.0.
- NO: remove sensio/framework-extra-bundle.

License

This component is under the MIT license. See the complete license in the LICENSE file.

Reporting an issue or a feature request

Issues and feature requests are tracked in the Github issue tracker.

Author Information

Developed with ♥ by Antonio J. García Lagar.

If you find this component useful, please add a ★ in the GitHub repository page and/or the Packagist package page.

ajgarlag / psr-http-message-bundle

Maintainers

Details