hamlet-framework/http-message

Hamlet Framework / HTTP / Request

Maintainers

Details

github.com/hamlet-framework/http-message

Source

Issues

Installs: 22 659

Dependents: 2

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 0

Open Issues: 0

0.0.5 2021-05-20 04:12 UTC

Requires

Requires (Dev)

Provides

GPL-2.0 f334b9f7528c3537814d37c0aa6acaebc33de145

  • Vasily Kartashov <info.woop@kartashov.com>

httpstreamurlresponsemessageurirequestpsr-7psr-17

This package is auto-updated.

Last update: 2024-10-29 05:22:44 UTC

README

CI Status Packagist Packagist Coverage Status Psalm coverage

PSR-7 and PSR-17 implementation.

This library generally provides you with three ways of creating objects.

Step-wise adjustments

The standard approach is to create an object through a series of adjustments.

$message = Message::empty()
    ->withProtocolVersion('1.1')
    ->withHeader('Host', 'example.net');

Note, that all with* methods are validating and in the example above we're creating 2 intermediate objects along the way.

Validating builders

We can avoid creating multiple objects by using a validating builder

$message = Message::validatingBuilder()
    ->withProtocolVersion('1.1')
    ->withBody($body)
    ->withHeaders($headers)
    ->build();

It offers the same level of validation as the previous method.

Non-validating builders

When creating messages within you application's secure boundaries, there is a way to avoid redundant argument validation by using non-validating builders

$message = Message::nonValidatingBuilder()
    ->withProtocolVersion('1.1')
    ->withBody($body)
    ->withHeaders($headers)
    ->build();

When in doubt use validating builders.

Outstanding tasks