php-fig/http-message
Http Message
PSR-7 HTTP Message Interfaces is a set of standardized PHP interfaces for representing HTTP request and response messages, URIs, streams, and uploaded files as immutable value objects. These interfaces define a common contract that enables interoperability between PHP frameworks and libraries when handling HTTP messages, ensuring that any implementation can be used interchangeably.
The interfaces model HTTP messages as immutable value objects where any modification produces a new instance, guaranteeing message integrity throughout the request lifecycle. They provide case-insensitive header access and retrieval, support for multi-valued headers, and stream-based body handling that enables efficient processing of large payloads without loading them entirely into memory. For server-side requests, the interfaces abstract PHP superglobals into structured objects with attributes for application-specific routing, and normalize uploaded file trees into consistent nested structures with safe file movement and stream access methods.
URI handling is provided through immutable value objects that parse RFC 3986 URIs once and expose individual component accessors for scheme, authority, path, query, and fragment. The interfaces also include validation mechanisms that reject malformed header names and values to prevent injection attacks and parsing errors. The package consists solely of interfaces and does not include any implementations, serving as a foundational contract for the PHP ecosystem.
Features
- Immutable HTTP Message Models - Models HTTP messages as immutable value objects, the foundational concept of the PSR-7 standard.
- Immutable HTTP Message - Models HTTP messages as immutable value objects, the core architectural pattern of this package.
- PHP Interface Standards - Defines the PSR-7 standard interfaces for HTTP messages, the core contract for PHP interoperability.
- Uploaded File Interfaces - Defines the PSR-7 UploadedFileInterface for safe file handling from PHP superglobals.
- Streamed Message Body Interfaces - Defines a stream interface for HTTP message bodies as a core part of the PSR-7 standard.
- Uploaded File Tree Normalizations - Provides a standard interface for normalizing PHP uploaded file data into structured objects.
- Parameter Bag Abstractions - Wraps PHP superglobals into structured request objects with typed parameter bag access.
- Multi-Value Headers - Supports returning header values as comma-separated strings or arrays for multi-valued headers.
- Casing Normalization - Normalizes HTTP header casing for case-insensitive retrieval while preserving original casing.
- Case-Insensitive Header Normalizers - Provides case-insensitive header normalization as a core part of the PSR-7 HTTP message interface.
- URI Construction and Parsing - Parses and composes HTTP and HTTPS URIs according to RFC 3986 with component accessors.
- URI Segment Readers and Modifiers - Provides accessors for individual URI segments like scheme, authority, path, query, and fragment.
- URI Value Object Interfaces - Defines the PSR-7 UriInterface for immutable URI value objects with component accessors.
- URI Value Object Parsings - Parses URIs once into value objects for efficient component access without repeated parsing.
- URI Value Object Representations - Represents URIs as immutable value objects parsed once for efficient segment access.
- HTTP Message Mapping - Models HTTP messages as immutable value objects, the foundational concept of the PSR-7 standard.
- Unified Message Element Accessors - Provides unified access to protocol version, headers, and body as a core part of the PSR-7 message interface.
- Standardized HTTP Message Interfaces - Provides the standardized interface for HTTP request and response messages, the core of the PSR-7 standard.
- HTTP Header Accessors - Provides case-insensitive header access and retrieval as a core part of the PSR-7 HTTP message interface.
- PHP Superglobal Request Abstractions - Abstracts PHP superglobals into structured request objects as a core part of the PSR-7 server request interface.
- Standardized HTTP Request Interfaces - Defines the standard interface for HTTP request messages as a core part of the PSR-7 standard.
- Standardized HTTP Response Interfaces - Defines the standard interface for HTTP response messages as a core part of the PSR-7 standard.
- Server-Side Request Parameter Accessors - Provides access to server-side request parameters as a core part of the PSR-7 server request interface.
- Body Streaming - Models message bodies as streamable objects for efficient processing of large payloads.
- Stream Interfaces - Provides the PSR-7 StreamInterface for efficient body handling without full memory loading.
- PHP Superglobal Abstractions - Abstracts PHP superglobals into structured request objects as a core part of the PSR-7 server request interface.
- Uploaded File Tree Normalizations - Normalizes PHP uploaded file data into a predictable tree of file objects.
- Host Header Rewriting - Synchronizes the Host header with the URI's host component as a feature of the PSR-7 request interface.
- URI-Based Host Header Synchronizers - Synchronizes the Host header with the URI's host component as a feature of the PSR-7 request interface.
- Safe Uploaded File Movers - Provides safe file movement for uploaded files as a feature of the PSR-7 uploaded file interface.
- Uploaded File Tree Normalizers - Normalizes the PHP $_FILES array into a consistent tree structure as a feature of the PSR-7 uploaded file interface.
- HTTP Header Validations - Enforces standardized naming and value constraints on HTTP headers to prevent injection attacks.
- Header Name and Value Validations - Rejects malformed header names and values to prevent CRLF injection and parsing attacks.
- Request Target Overrides - Allows overriding the default request target to support specialized HTTP request forms.
- Request-Target Form Handlers - Supports all four forms of the HTTP request-target as a feature of the PSR-7 request interface.
- Request Target Representations - Defines the four standard forms of HTTP request targets for message representation.
