symfony/http-foundation
Http Foundation
Symfony HttpFoundation is an object-oriented library that models HTTP requests and responses as structured objects, wrapping PHP superglobals into typed parameter bags and providing dedicated objects for headers, cookies, and file uploads. It serves as the foundational layer for building HTTP-based applications in PHP, offering a complete abstraction for reading request data, constructing responses, and managing the full request-response lifecycle.
The library distinguishes itself through composable request matchers that check incoming requests against conditions like IP, method, host, or path, and through its support for streaming responses and server-sent events for real-time data delivery. It also provides session storage abstraction for managing user data across requests, HTTP cache header management for controlling client and proxy caching behavior, and file serving with automatic range request handling and optional X-Sendfile delegation.
Additional capabilities include JSON API response handling, URL generation for converting paths into absolute or relative URLs, and cookie management through dedicated cookie objects with configurable attributes. The library also supports request simulation for testing and development without relying on PHP superglobals.
Features
- HTTP Request-Response Object Layers - Provides the foundational object-oriented layer for modeling HTTP requests and responses in PHP.
- Request Matching - Implements composable matcher classes that check requests against IP, method, host, or path conditions.
- Cookie Objects - Represents HTTP cookies as dedicated objects with configurable attributes for domain, path, expiration, and security flags.
- Parameter Bag Abstractions - Wraps PHP superglobals into typed parameter bag objects for structured access to query, body, cookies, and headers.
- Request Matchers - Checks incoming requests against composable rules for IP, method, host, or path using dedicated matcher classes.
- Cookie Objects - Provides dedicated cookie objects with configurable attributes for attaching to HTTP responses.
- Request Data Accessors - Provides structured property objects for reading query, body, cookies, files, and headers from incoming requests.
- HTTP Response Builders - Ships a structured object for constructing and sending HTTP responses with status codes, headers, and body content.
- Header Bag Management - Manages HTTP response headers through a dedicated bag object with methods for cache control, cookies, and content negotiation.
- Raw HTTP Request Construction - Wraps raw PHP superglobals into structured objects with methods for headers, parameters, and file uploads.
- Session Storage - Manages user session data across requests through a server-side storage mechanism decoupled from request handling.
- HTTP Cache Headers - Manages cache-control, expiration, ETag, and last-modified headers for HTTP caching.
- Server-Side Session Stores - Provides server-side storage and retrieval of user session information across HTTP requests.
- HTTP Range Request Handling - Serves files with automatic support for HTTP range requests and optional X-Sendfile delegation to the web server.
- Range Request File Servings - Ships a file serving component with automatic range request handling and X-Sendfile delegation.
- Composable Request Matchers - Provides composable matcher classes that check requests against IP, method, host, or path conditions.
- Composable - Provides composable matcher classes that check requests against IP, method, host, or path conditions.
- Server-Sent Events - Pushes real-time updates over a single long-lived HTTP connection using a structured event stream format.
- Response Streaming - Sends response content incrementally using callables or iterables for large payloads and real-time data.
- Request Simulators - Allows creating request objects from URIs and parameters without relying on PHP superglobals for testing.
- HTTP Redirects - Sends HTTP redirect responses with status codes and location headers to guide clients to different URLs.
- JSON Response Formatters - Encodes data as JSON and sets the appropriate Content-Type header for API responses.
- Streaming Response Handlers - Supports sending response content incrementally, including JSON streaming and server-sent events.
- URL Generation - Converts paths into absolute or relative URLs for use in responses or links.
