The document provides a comprehensive guide on setting up PSR-15 middleware using Zend Expressive for PHP development, detailing installation requirements, routing configurations, and middleware operations. It outlines the role of HTTP messages, request handlers, and injects dependency while emphasizing a modular structure for application development. Additionally, it includes command line instructions for creating various components within the Zend framework.

1. Zend Expressive 3 PSR-15
PSR-15 Middleware in Minutes

2. Juciellen
Cabrera
PHP Developer - 4Linux | Rankdone
@jucycabrera
#PHPWomen

4. Expressive
PSR-15 Middleware in Minutes
2018-03-16
>= PHP 7.1

5. Instalação
composer create-project zendframework/zend-expressive-skeleton expressive

6. requires
● php: ^7.1
● fig/http-message-util: ^1.1.2
● psr/container: ^1.0
● psr/http-message: ^1.0.1
● psr/http-server-middleware: ^1.0
● zendframework/zend-expressive-router: ^3.0
● zendframework/zend-expressive-template: ^2.0
● zendframework/zend-httphandlerrunner: ^1.0.1
● zendframework/zend-stratigility: ^3.0

7. [1] Minimal (no default middleware, templates, or
assets; configuration only)
[2] Flat (flat source code structure; default selection)
[3] Modular (modular source code structure;
recommended)

9. Rotas

10. ● Aura.Router
● Fast Router
● Zend Route

11. return function (Application $app, MiddlewareFactory $factory, ContainerInterface
$container) : void {
$app->get('/', AppActionHomePageAction::class, 'home');
$app->post('/album', AppActionAlbumCreateAction::class, 'album.create');
$app->put('/album/:id', AppActionAlbumUpdateAction::class, 'album.put');
$app->patch('/album/:id', AppActionAlbumUpdateAction::class, 'album.patch');
$app->delete('/album/:id', AppActionAlbumDeleteAction::class, 'album.delete');
$app->route('/contact', AppActionContactAction::class, ['GET', 'POST', ...], 'contact');
$app->any('/contact', AppActionContactAction::class)->setName('contact');
$app->route(
'/contact',
AppActionContactAction::class,
ZendExpressiveRouterRoute::HTTP_METHOD_ANY,
'contact'
);

12. Injeção de Dependência

13. [1] Aura.Di
[2] Pimple
[3] zend-servicemanager
[4] Auryn
[5] Symfony DI Container

14. Templates

15. [1] Plates
[2] Twig
[3] zend-view installs zend-servicemanager
[n] None of the above

16. Manipulação de erro

17. [1] Whoops
[n] None of the above

18. PSR-7
HTTP message interfaces
Interfaces de mensagens HTTP

19. HTTP messages are the foundation of web
development. Web browsers and HTTP
clients such as cURL create HTTP request messages
that are sent to a web server,
which provides an HTTP response message.
Mensagens HTTP são a base do desenvolvimento
web. Browsers e clients HTTP como cURL criam
mensagens de requisição HTTP que são enviadas
para um servidor web, que provisiona uma
mensagem de resposta HTTP.

20. Server-side code receives an HTTP
request message, and returns an HTTP response
message.
O código do lado do servidor recebe uma
mensagem de requisição HTTP e retorna uma
mensagem de resposta HTTP.

21. Interfaces
● MessageInterface.php
● RequestInterface.php
● ResponseInterface.php
● ServerRequestInterface.php
● StreamInterface.php
● UploadedFileInterface.php
● UriInterface.php

22. <?php
namespace PsrHttpMessage;
interface MessageInterface
{
public function getProtocolVersion();
public function withProtocolVersion($version);
public function getHeaders();
public function hasHeader($name);
public function getHeader($name);
public function getHeaderLine($name);
public function withHeader($name, $value);
public function withAddedHeader($name, $value);
public function withoutHeader($name);
public function getBody();
public function withBody(StreamInterface $body);
}

23. PSR-15

24. A request handler is an individual component that
processes a request and
produces a response, as defined by PSR-7.
Um request handler (manipulador de requisição é
um componente individual que processa uma
requisição e produz uma resposta, como definido
pela PSR-7.

25. namespace PsrHttpServer;
use PsrHttpMessageResponseInterface;
use PsrHttpMessageServerRequestInterface;
interface RequestHandlerInterface
{
public function handle(ServerRequestInterface $request):
ResponseInterface;
}

26. namespace AppHandler;
use PsrHttpMessageResponseInterface;
use PsrHttpMessageServerRequestInterface;
use PsrHttpServerRequestHandlerInterface;
use ZendDiactorosResponseJsonResponse;
class PingHandler implements RequestHandlerInterface
{
public function handle(ServerRequestInterface $request) : ResponseInterface
{
return new JsonResponse(['ack' => time()]);
}
}

27. Middleware is any code sitting between a request
and a response.
Middleware é qualquer código entre a requisição e a
resposta.

28. Middlewares
● Authentication
● Authorization
● CORS
● Log
● Routing

29. namespace PsrHttpServer;
use PsrHttpMessageResponseInterface;
use PsrHttpMessageServerRequestInterface;
interface MiddlewareInterface
{
public function process(ServerRequestInterface $request,
RequestHandlerInterface $handler): ResponseInterface;
}

30. Pipeline

31. The terminology "pipeline" is often used to describe the
onion. One way of looking at the "onion" is as a queue
(FIFO). This means that the first middleware on the
queue is executed first, and this invokes the next.
A terminologia “pipeline” é frequentemente usada para
descrever uma cebola. Uma forma de olhar para a
cebola é como uma fila (FIFO). Isso significa que o
primeiro middleware da fila é executado primeiro e
invoca o próximo.

32. return function (Application $app, MiddlewareFactory $factory, ContainerInterface
$container) : void {
$app->pipe(ErrorHandler::class);
$app->pipe(ServerUrlMiddleware::class);
$app->pipe(RouteMiddleware::class);
$app->pipe(ImplicitHeadMiddleware::class);
$app->pipe(ImplicitOptionsMiddleware::class);
$app->pipe(MethodNotAllowedMiddleware::class);
$app->pipe(UrlHelperMiddleware::class);
$app->pipe(DispatchMiddleware::class);
$app->pipe(NotFoundHandler::class);
}

33. Command Line Tooling

34. composer expressive
handler:create
middleware:create
module:create
module:register
composer run --timeout=0 serve

35. composer expressive handler:create “AppHandlerPhpCommunitiesCreateHandler”
PhpCommunitiesCreateHandler
PhpCommunitiesCreateHandlerFactory

36. Referências
https://www.php-fig.org/psr/psr-7/
https://www.php-fig.org/psr/psr-15/
https://docs.zendframework.com/zend-expressive/v3/getting-started/quick-start/
https://framework.zend.com/blog/2018-03-16-expressive-3.html
https://packagist.org/packages/zendframework/zend-expressive

37. Obrigada!
@jucycabrera
jucarol17@gmail.com