componenta/http-emitter

PSR-7 response emitter for Componenta

Maintainers

Package info

github.com/componenta/http-emitter

pkg:composer/componenta/http-emitter

Statistics

Installs: 7

Dependents: 2

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.0.0 2026-06-15 10:59 UTC

Requires

MIT 5d8a19e3f244bc1a899ee22c26e3350304014e16

This package is auto-updated.

Last update: 2026-06-15 12:06:42 UTC

README

PSR-7 response emitter for Componenta HTTP applications. It sends status, headers, and body content to PHP output.

Use this package at the outer HTTP entry point after the PSR-15 pipeline has produced a ResponseInterface.

Boundary

This package only emits an already built response. It does not build responses, create server requests, or run middleware. Use componenta/http-responder for response creation and componenta/app-http for the HTTP runtime pipeline.

Installation

composer require componenta/http-emitter

Componenta\Http\EmitterConfigProvider is exposed through Composer metadata.

Public API

EmitterInterface::emit(ResponseInterface $response): void emits a response. Emitter is the default implementation.

use Componenta\Http\EmitterInterface;

/** @var EmitterInterface $emitter */
$emitter->emit($response);

Emitter accepts an optional chunk size:

$emitter = new Componenta\Http\Emitter(chunkSize: 16_384);

EmitStrategy controls body emission:

Case Meaning
Full Emit the full response body.
Partial Emit a range response body.
NoBody Emit headers without a body.

EmitterException is thrown for emitter-level failures.

Runtime Behavior

Before emitting, Emitter checks that headers have not already been sent and clears active output buffers. Then it chooses a strategy from the response status and headers:

Strategy When it is used
NoBody Informational statuses, 204, 304, 416, or unsatisfiable Content-Range.
Partial Status 206 with a Content-Range header.
Full All other responses.

For full responses, the emitter adds Content-Length when the stream size is known and the header is missing. For seekable streams with known size it also adds Accept-Ranges: bytes. Bodies are streamed in chunks and stop early if the client disconnects.

For partial responses, a valid Content-Range controls the emitted byte range when the body stream is seekable. If the range cannot be parsed or the stream is not seekable, the emitter falls back to emitting the full body that is present in the response.

Configuration

The config provider registers Emitter and aliases EmitterInterface to it. Applications normally receive the emitter from the container.

Related Packages