Installation requirements

The following example depends on the laminas-httphandlerrunner component. You can install it with the following command:

$ composer require laminas/laminas-httphandlerrunner

Creating an application consists of 3 steps:

  • Create middleware or a middleware pipeline
  • Create a server, using the middleware
  • Instruct the server to listen for a request
use Laminas\Diactoros\ResponseFactory;
use Laminas\Diactoros\ServerRequestFactory;
use Laminas\HttpHandlerRunner\Emitter\SapiEmitter;
use Laminas\HttpHandlerRunner\RequestHandlerRunner;
use Laminas\Stratigility\MiddlewarePipe;

require __DIR__ . '/../vendor/autoload.php';

$app    = new MiddlewarePipe();
$server = new RequestHandlerRunner(
    new SapiEmitter(),
    static function () {
        return ServerRequestFactory::fromGlobals();
    static function (\Throwable $e) {
        $response = (new ResponseFactory())->createResponse(500);
            'An error occurred: %s',
        return $response;


The above example is useless by itself until you pipe middleware into the application.

Found a mistake or want to contribute to the documentation? Edit this page on GitHub!