chillerlan/psr-7

A PSR-7 HTTP message and PSR-17 HTTP factory implementation.

1.0.0 2024-03-09 21:37 UTC

Requires

• php: ^8.1
• ext-mbstring: *
• chillerlan/php-http-message-utils: ^2.1.1
• fig/http-message-util: ^1.1.5
• psr/http-factory: ^1.0
• psr/http-message: ^1.1

Requires (Dev)

• ext-simplexml: *
• http-interop/http-factory-tests: ^2.1
• phan/phan: ^5.4
• phpmd/phpmd: ^2.15
• phpunit/phpunit: ^10.5
• squizlabs/php_codesniffer: ^3.9

Suggests

• chillerlan/php-httpinterface: A PSR-18 HTTP client implementation
• chillerlan/php-oauth: A PSR-7 OAuth client/handler that also acts as PSR-18 HTTP client

Provides

• psr/http-factory-implementation: 1.0
• psr/http-message-implementation: 1.0

MIT

• smiley
• Contributors

• http
• stream
• url
• response
• message
• uri
• request
• factory
• psr-7
• psr-17

README

A PSR-7/PSR-17 HTTP message and factory implementation.

Overview

Features

• PSR-7 HTTP message implementation
• PSR-17 HTTP factory implementation
• MultipartStreamBuilder based on PSR-7 Message objects (RFC-2046, section 5.1)

Requirements

• PHP 8.1+
  • ext-mbstring

Documentation

The documentation of the PSR-7 interfaces can be found over at https://www.php-fig.org/psr/psr-7/.

NOTE: This library has abandoned the paranoid "value object" "immuatbility" that is dictated by PSR-7 for it is horseshit. The pseudo-immutability gets in the way more often (always) than it is useful (never) and creates endless overhead. If you want your objects to be immutable for whatever reason, just fucking clone them and don't force countless libraries to do that for you instead. If you don't like it, just use Guzzle instead (spoiler: you won't notice the difference).

Further, this library still only implements psr/http-message v1.1, as the v2.0 release (06/2023) has return types added that conflict with the static return type that was introduced in PHP 8 (11/2020).

Auto generated API documentation

The API documentation can be auto generated with phpDocumentor. There is an online version available via the gh-pages branch that is automatically deployed on each push to main.

Locally created docs will appear in .build/phpdocs/. If you'd like to create local docs, please follow these steps:

• download phpDocumentor v3+ as .phar archive
• run it in the repository root directory:
  • on Windows c:\path\to\php.exe c:\path\to\phpDocumentor.phar --config=phpdoc.xml
  • on Linux just php /path/to/phpDocumentor.phar --config=phpdoc.xml
• open index.html in a browser
• profit!

Disclaimer

Use at your own risk!