legatus / http-errors
HTTP exceptions for PSR-7 applications
Requires
- php: >=7.4
- psr/http-message: ^1.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^2.16
- infection/infection: ^0.16.4
- phpunit/phpunit: ^9.0
- psr/http-server-middleware: ^1.0
- vimeo/psalm: ^3.7
This package is auto-updated.
Last update: 2024-11-26 07:46:26 UTC
README
HTTP exceptions for PSR-7 applications
Installation
You can install the Http Errors component using Composer:
composer require legatus/http-errors
Quick Start
<?php declare(strict_types=1); use Psr\Http\Message\ResponseInterface as Response; use Psr\Http\Message\ServerRequestInterface as Request; use Psr\Http\Server\MiddlewareInterface; use Psr\Http\Server\RequestHandlerInterface as Next; /** * Class SomeAuthorizationMiddleware */ class SomeAuthorizationMiddleware implements MiddlewareInterface { public function process(Request $request, Next $next): Response { if (!$this->isAuthorized($request)) { // Throw the exception and handle it in an upstream middleware throw new Legatus\Http\Unauthorized($request); } return $next->handle($request); } }
For more details you can check the online documentation here.
Project status & release process
While this library is still under development, it is well tested and should be stable enough to use in production environments.
The current releases are numbered 0.x.y. When a non-breaking change is introduced (adding new methods, optimizing existing code, etc.), y is incremented.
When a breaking change is introduced, a new 0.x version cycle is always started.
It is therefore safe to lock your project to a given release cycle, such as 0.2.*.
If you need to upgrade to a newer release cycle, check the release history for a list of changes introduced by each further 0.x.0 version.
Community
We still do not have a community channel. If you would like to help with that, you can let me know!
Contributing
Read the contributing guide to know how can you contribute to Legatus.
Security Issues
Please report security issues privately by email and give us a period of grace before disclosing.
About Legatus
Legatus is a personal open source project led by MatÃas Navarro Carter and developed by contributors.