crell/http-tools

0.3.0 2025-05-15 05:13 UTC

Requires

• php: ~8.1
• psr/http-factory: ^1.1
• psr/http-message: ^1.0|^2.0
• psr/http-server-handler: ^1.0
• psr/http-server-middleware: ^1.0

Requires (Dev)

• nyholm/psr7: ^1.8
• phpbench/phpbench: ^1.4.1
• phpstan/phpstan: ^2.1.11
• phpunit/phpunit: ^10.5.46

LGPL-3.0-or-later

• Larry Garfield

README

This library is a loose collection of tools to make working with the PSR HTTP stack a bit easier.

Included tools

HttpStatus

Yet another Enum listing the different typical HTTP response codes used.

ResponseBuilder

ResponseBuilder is a simple convenience wrapper around the PSR-17 factory classes. It provides a single, easy to use "builder" class that produces common PSR-7 response objects types. You may bring your own PSR-17 factory of your choice.

See the ResponseBuilder class, as its methods should be fairly self-explantory just from their names.

CacheHeaderMiddleware

This zero-configuration middleware ensures that cache headers are stripped from requests/responses that should not have them, according to the HTTP spec.

EnforceHeadMiddleware

Ensures that the response to a HEAD request has an empty body, even if one was incorrectly set.

DefaultContentTypeMiddleware

Allows setting a default content-type and accept header value on incoming requests. Useful for APIs that allow clients to not specify those headers, without code further on needing to account for it being missing.

Contributing

Please see CONTRIBUTING and CODE_OF_CONDUCT for details.

Security

If you discover any security related issues, please use the GitHub security reporting form rather than the issue queue.

Credits

• Larry Garfield
• All Contributors

License

The Lesser GPL version 3 or later. Please see License File for more information.