Download the PHP package waffle-commons/http without Composer
On this page you can find all versions of the php package waffle-commons/http. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download waffle-commons/http
More information about waffle-commons/http
Files in waffle-commons/http
Package http
Short Description PSR-7 HTTP messages and PSR-17 factories for Waffle Commons: immutable request/response objects, streams, and contained file uploads.
License MIT
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package http
Waffle HTTP Component
Release:
0.1.0-beta6|CHANGELOG.mdPSR Compliance: PSR-7 (HTTP Messages), PSR-17 (HTTP Factories)
A strict, immutable PSR-7/17 implementation tuned for FrankenPHP worker mode. No singletons, no superglobal touching outside the explicit GlobalsFactory. Streams are seekable-aware; the ResponseEmitter chunks bodies to avoid loading large payloads into memory.
📦 Installation
🧱 Surface
| Class | PSR | Role |
|---|---|---|
Waffle\Commons\Http\Request |
PSR-7 | Outbound HTTP request message. |
Waffle\Commons\Http\ServerRequest |
PSR-7 | Inbound HTTP request (the kernel input). |
Waffle\Commons\Http\Response |
PSR-7 | HTTP response message. |
Waffle\Commons\Http\Stream |
PSR-7 | Resource-backed StreamInterface. |
Waffle\Commons\Http\Uri |
PSR-7 | Immutable URI. |
Waffle\Commons\Http\UploadedFile |
PSR-7 | File-upload representation. |
Waffle\Commons\Http\Abstract\AbstractMessage |
— | Shared base for Request / ServerRequest / Response. |
Waffle\Commons\Http\Factory\RequestFactory |
PSR-17 | createRequest(). |
Waffle\Commons\Http\Factory\ServerRequestFactory |
PSR-17 | createServerRequest(). |
Waffle\Commons\Http\Factory\ResponseFactory |
PSR-17 | createResponse(). |
Waffle\Commons\Http\Factory\StreamFactory |
PSR-17 | createStream(), createStreamFromFile(), createStreamFromResource(). |
Waffle\Commons\Http\Factory\UriFactory |
PSR-17 | createUri(). |
Waffle\Commons\Http\Factory\UploadedFileFactory |
PSR-17 | createUploadedFile(). |
Waffle\Commons\Http\Factory\GlobalsFactory |
— | Implements GlobalsFactoryInterface: builds a PSR-7 ServerRequest from $_SERVER, $_GET, $_POST, $_COOKIE, $_FILES, and php://input. |
Waffle\Commons\Http\Emitter\ResponseEmitter |
— | Implements ResponseEmitterInterface: sends status line, headers and chunked body. |
🚀 Bootstrap a server request
The factory takes an optional (callable(): StreamInterface) $bodyStreamFactory so tests can inject a synthetic body without touching php://input:
Security note.
GlobalsFactorydoes not enforce trusted hosts. Host-header anti-poisoning is handled one layer up byWaffle\Commons\Pipeline\Middleware\TrustedHostMiddleware, which sits betweenErrorHandlerMiddlewareandCoreRoutingMiddlewarein the PSR-15 stack.
📤 Emit a response
The emitter:
- Throws
\RuntimeExceptionif headers are already sent. - Sends one
header()per header value (combining for non-Set-Cookieheaders). - Reads the response body in 8 KiB chunks via
StreamInterface::read(), so streaming large payloads is memory-bounded.
🐘 PHP 8.5 features used
- Immutable, named-argument-friendly factories — every
with…()accessor returns a clone. - Typed properties + constructor promotion across messages.
- Strict types in every file (
declare(strict_types=1);). - The
ResponseEmitter::emit()signature uses#[\Override]to assert the contract.
🧭 Architectural boundary (mago guard)
An active dependency perimeter is enforced on every CI run by vendor/bin/mago guard (bundled into composer mago; zero baselines). The rules live in mago.toml under [guard.perimeter] — a forbidden use statement fails the build, not a reviewer.
Production code under Waffle\Commons\Http may depend only on:
Waffle\Commons\Http\**— itselfWaffle\Commons\Contracts\**— the shared contracts package, the only Waffle dependency permittedPsr\**— PSR interfaces (PSR-7 / PSR-17)@global+Psl\**— PHP core and the PHP Standard Library
Test code under WaffleTests\Commons\Http is unrestricted (@all); the php-mock bootstrap fixtures noted under Testing are listed in [guard].excludes because they intentionally re-declare the production namespace. Structural rules are guarded too: interfaces must be named *Interface, Exception\** classes must end in *Exception, and any Enum\** namespace may hold only enum declarations.
Contract-first, component-agnostic by construction: components compose through waffle-commons/contracts, never directly through one another.
🧪 Testing
Mock-bootstrap files under tests/src/StreamTest.php, tests/src/UploadedFileTest.php, tests/src/Factory/StreamFactoryTest.php, and tests/src/Emitter/ResponseEmitterTest.php intentionally declare the production namespace to override built-in PHP functions via php-mock-phpunit. They are listed in mago.toml [guard].excludes for that reason.
📚 Documentation
Full guides live in the central Diátaxis documentation tree:
📄 License
MIT — see LICENSE.md.
All versions of http with dependencies
psr/http-message Version ^2.0
psr/http-factory Version ^1.1
waffle-commons/contracts Version self.version
waffle-commons/utils Version self.version