README

Minimal HTTP primitives shared by Componenta HTTP packages.

This package intentionally has no PSR-7 implementation, PSR-17 factory, middleware, responder, request creator, emitter, router, or application runtime. Those pieces live in separate packages so componenta/http can stay dependency-free.

Package Boundary

Installation

composer require componenta/http

Requirements

• PHP ^8.4

The package has no Composer dependencies.

HTTP Method

HttpMethod normalizes method names and exposes RFC-oriented properties for common routing and middleware decisions.

use Componenta\Http\HttpMethod;

$method = HttpMethod::from('post');

$method->value;        // POST
$method->isSafe;       // false
$method->isIdempotent; // false
$method->isCacheable;  // false
$method->requiresBody; // true

Standard helpers are available for common methods:

HttpMethod::get();
HttpMethod::post();
HttpMethod::put();
HttpMethod::delete();
HttpMethod::patch();

Custom non-empty methods are allowed and normalized to uppercase. Use HttpMethod::tryFrom() when an empty value should return null instead of throwing.

Header Constants

Header groups common HTTP header names as constants and includes helper lists for request, response, security, cache, and CORS headers.

use Componenta\Http\Header;

$response = $response->withHeader(Header::CONTENT_TYPE, 'application/json');

Header::isRequestHeader(Header::AUTHORIZATION); // true
Header::getSecurityHeaders();                   // list<string>

The class is a static helper and is not meant to be instantiated.

HTTP Exceptions

All status-specific exceptions extend Componenta\Http\Exception\HttpException.

use Componenta\Http\Exception\NotFoundException;

throw new NotFoundException('Post not found');

HttpException exposes:

Use HttpExceptionFactory::fromStatusCode() when the status code is known only at runtime.

use Componenta\Http\Exception\HttpExceptionFactory;

$exception = HttpExceptionFactory::fromStatusCode(409, 'Revision conflict');

HttpExceptionFactory::isClientError() and HttpExceptionFactory::isServerError() classify existing HttpException instances.

Some status-specific exceptions also store data that is needed to build a correct HTTP response:

HttpExceptionFactory::fromStatusCode() creates generic instances. Prefer the concrete constructors above when the response must include these headers.

Related Packages