zendframework/zend-expressive

PSR-15 Middleware Microframework

zend-expressive

Repository abandoned 2019-12-31

This repository has moved to mezzio/mezzio., _(*1)

, _(*2)

Develop PSR-7 middleware applications in minutes!, _(*3)

zend-expressive builds on zend-stratigility to provide a minimalist PSR-7 middleware framework for PHP, with the following features:, _(*4)

• Routing. Choose your own router; we support:
  • Aura.Router
  • FastRoute
  • zend-router
• DI Containers, via PSR-11 Container. Middleware matched via routing is retrieved from the composed container.
• Optionally, templating. We support:
  • Plates
  • Twig
  • ZF2's PhpRenderer

Installation

We provide two ways to install Expressive, both using Composer: via our skeleton project and installer, or manually., _(*5)

Using the skeleton + installer

The simplest way to install and get started is using the skeleton project, which includes installer scripts for choosing a router, dependency injection container, and optionally a template renderer and/or error handler. The skeleton also provides configuration for officially supported dependencies., _(*6)

To use the skeleton, use Composer's create-project command:, _(*7)

$ composer create-project zendframework/zend-expressive-skeleton <project dir>

This will prompt you through choosing your dependencies, and then create and install the project in the <project dir> (omitting the <project dir> will create and install in a zend-expressive-skeleton/ directory)., _(*8)

Manual Composer installation

You can install Expressive standalone using Composer:, _(*9)

$ composer require zendframework/zend-expressive

However, at this point, Expressive is not usable, as you need to supply minimally:, _(*10)

• a router.
• a dependency injection container.

We currently support and provide the following routing integrations:, _(*11)

• Aura.Router: composer require zendframework/zend-expressive-aurarouter
• FastRoute: composer require zendframework/zend-expressive-fastroute
• zend-router: composer require zendframework/zend-expressive-zendrouter

We recommend using a dependency injection container, and typehint against PSR-11 Container. We can recommend the following implementations:, _(*12)

• zend-servicemanager: composer require zendframework/zend-servicemanager
• Pimple (see docs for more details): composer require zendframework/zend-pimple-config
• Aura.Di (see docs for more details): composer require zendframework/zend-auradi-config

Additionally, you may optionally want to install a template renderer implementation, and/or an error handling integration. These are covered in the documentation., _(*13)

Documentation

Documentation is in the doc tree, and can be compiled using mkdocs:, _(*14)

$ mkdocs build

Additionally, public-facing, browseable documentation is available at https://docs.zendframework.com/zend-expressive/, _(*15)