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:

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:

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

• componenta/app-http uses the emitter in the HTTP runtime.
• componenta/http-responder builds PSR-7 responses.