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,
sends headers and output using PHP's standard SAPI mechanisms (the
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:
Applicationcomposes an emitter, and you can specify an alternate emitter during instantiation, or via the
Zend\Diactoros\Response\EmitterInterfaceservice 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 boolean
falsewill cause execution of the stack to short-circuit.
EmitterStackby default, with an
SapiEmittercomposed at the bottom of the stack.
EmitterStack is an
SplStack extension that implements
EmitterInterface. You can add emitters to the stack by pushing them on:
As a stack, execution is in LIFO (last in, first out) order; the first emitter on the stack will be evaluated last.
Deprecated with version 2.2
Starting in version 2.2, the
EmitterStackis deprecated, and moved, along with the zend-diactoros
EmitterInterfaceand implementations, to a new package, zend-httphandlerrunner.
The interface and the
EmitterStackare roughly identical to what is present in version 2; if you are defining a
Zend\Diactoros\Emitter\EmitterInterfaceservice of your own, you will need to update it in that version.