Caution
The documentation you are viewing is for an older version of this component.
Switch to the latest (v3) version.
Features
In This Article
Emitters
To simplify the usage of Expressive, we added the run()
method, which handles
the incoming request, and emits a response.
The latter aspect, emitting the response, is the responsibility of an emitter. An emitter accepts a response instance, and then does something with it, usually sending the response back to a browser.
Diactoros defines an EmitterInterface
, and — as of the time we write this — a
single emitter implementation, Zend\Diactoros\Response\SapiEmitter
, which
sends headers and output using PHP's standard SAPI mechanisms (the header()
method and the output buffer).
We recognize that there are times when you may want to use alternate emitter implementations; for example, if you use React, the SAPI emitter will likely not work for you.
To facilitate alternate emitters, we offer two facilities:
- First,
Application
composes an emitter, and you can specify an alternate emitter during instantiation, or via theZend\Diactoros\Response\EmitterInterface
service when using the container factory. - Second, we provide
Zend\Expressive\Emitter\EmitterStack
, which allows you to compose multiple emitter strategies; the first to return a value other than booleanfalse
will cause execution of the stack to short-circuit.Application
composes anEmitterStack
by default, with anSapiEmitter
composed at the bottom of the stack.
EmitterStack
The EmitterStack
is an SplStack
extension that implements
EmitterInterface
. You can add emitters to the stack by pushing them on:
$stack->push($emitterInstance);
As a stack, execution is in LIFO (last in, first out) order; the first emitter on the stack will be evaluated last.
Found a mistake or want to contribute to the documentation? Edit this page on GitHub!