shrikeh / teapot
PHP HTTP Response Status library
Installs: 2 092 994
Dependents: 42
Suggesters: 1
Security: 0
Stars: 275
Watchers: 12
Forks: 16
Open Issues: 1
Requires
- php: >=8.0
- psr/http-message: ^1.1 || ^2.0
- teapot/status-code: ^2.1
Requires (Dev)
- ergebnis/php-cs-fixer-config: ^5.9.2
- phpspec/phpspec: ^7.4
- vimeo/psalm: ^5.14.1
This package is auto-updated.
Last update: 2024-10-07 12:25:37 UTC
README
This is a very simple library that aims to aid verbosity in any Web-based application by defining clearly the HTTP 1.1 response codes as constants. It includes two main components: an interface, which contains the constants, and an exception specifically for HTTP.
Usage
Using the StatusCodes interface
Assuming for a moment a PHPUnit test on a cURL client response:
<?php /** * @dataProvider someUrlProvider */ public function testResponseIsOK($url) { $client = new Client($url); $response = $client->get(); $this->assertSame(200, $response->getStatusCode()); }
This becomes:
<?php use Teapot\StatusCode; ... $this->assertSame(StatusCode::OK, $response->getStatusCode());
While this is a trivial example, the additional verbosity of the code is clearer with other HTTP status codes:
<?php use Teapot\StatusCode; $code = $response->getStatusCode(); $this->assertNotEquals(StatusCode::NOT_FOUND, $code); $this->assertNotEquals(StatusCode::FORBIDDEN, $code); $this->assertNotEquals(StatusCode::MOVED_PERMANENTLY, $code); $this->assertSame(StatusCode::CREATED, $code);
As StatusCode
is an interface without any methods, you can directly implement it if you prefer:
<?php use Teapot\StatusCode; class FooController implements StatusCode { public function badAction() { if ($this->request->getMethod() == 'POST') { throw new \Exception('Bad!', self::METHOD_NOT_ALLOWED); } } }
This may be beneficial in an abstract class, so that child classes don't need to explicitly use the interface.
There are various "helper" interfaces within the library, such as WebDAV and Http. Additionally, the various status codes are split into the RFCs that defined them: the Http helper interface extends RFCs 2616, 2324, and 2774, for example. This allows you very granular control of what status codes you want to allow within your application.
All constants have doc blocks that use the official W3C and IETF draft specification descriptions of the status code, to aid IDEs and for reference.
Using the HttpException
The HttpException
is very straightforward. It simply is a named exception to aid verbosity:
<?php use Teapot\HttpException; use Teapot\StatusCode; throw new HttpException( 'Sorry this page does not exist!', StatusCode::NOT_FOUND );
The exception itself uses the StatusCode
interface, allowing you to avoid manually and explicitly importing it if you prefer:
<?php use Teapot\HttpException; throw new HttpException( 'Sorry this page does not exist!', HttpException::NOT_FOUND );
Installation
Run the following command.
composer require shrikeh/teapot
Coding Standards
The entire library is intended to be PSR-1, PSR-2 and PSR-4 compliant.
Get in touch
If you have any suggestions, feel free to email me at barney+teapot@shrikeh.net or ping me on Twitter with @shrikeh.