A simple PSR-7 and PSR-17 implementation.
It aims to provide an easy and efficient way to handle HTTP requests and responses.
The package can be installed via composer. Simply run the following command:
composer require borschphp/httpmessage
The package provides implementations for the following PSR-7 interfaces:
Psr\Http\Message\RequestInterfacePsr\Http\Message\ResponseInterfacePsr\Http\Message\ServerRequestInterfacePsr\Http\Message\StreamInterfacePsr\Http\Message\UriInterfacePsr\Http\Message\UploadedFileInterface
You can use the factories provided by the package to create instances of these classes:
use Borsch\Http\Factory\{
RequestFactory,
ResponseFactory
};
$requestFactory = new RequestFactory();
$request = $requestFactory->createRequest('GET', 'https://example.com');
$responseFactory = new ResponseFactory();
$response = $responseFactory->createResponse(200, 'OK');
$response->getBody()->write('<h1>Hello world !</h1>');The package also provides factories for the following PSR-17 interfaces:
Psr\Http\Message\RequestFactoryInterfacePsr\Http\Message\ResponseFactoryInterfacePsr\Http\Message\ServerRequestFactoryInterfacePsr\Http\Message\StreamFactoryInterfacePsr\Http\Message\UriFactoryInterfacePsr\Http\Message\UploadedFileFactoryInterface
You can use these factories to create instances of the PSR-7 classes.
The package also includes custom response classes to improve usability and readiness:
Borsch\Http\Response\EmptyResponseBorsch\Http\Response\TextResponseBorsch\Http\Response\HtmlResponseBorsch\Http\Response\JsonResponseBorsch\Http\Response\XmlResponseBorsch\Http\Response\RedirectResponse
These classes are built on top of the PSR-7 implementation, and they offer a convenient way to create specific types of
responses. For example, instead of creating a response and setting the correct headers and content manually, you can use
the JsonResponse class to automatically set the Content-Type header to application/json and the body to the json
encoded data.
use Borsch\Http\Response\JsonResponse;
$my_json_data = ['foo' => 'bar', 'baz' => 42];
return new JsonResponse($my_json_data);The package includes a set of tests (made with Pest) to ensure that everything is working as expected.
You can run the tests by executing the following command:
./vendor/bin/pestMutation testing has also been used to create this package, with Infection.
More information on Infection page.
To run mutation tests, install infection as described in the documentation, then run this command:
XDEBUG_MODE=coverage infectionAn text based and HTML report will be generated in the project folder.
The package is licensed under the MIT license. See License File for more information.