▶️ Honza představíuje PHP microframework s plnou podporou standardu PSR, který je velmi jednoduchý a zároveň dokonalý. Přidává i pár tipů pro validaci příchozích requestů, end-to-end testování bez nutnosti poslat HTTP request a ukázku, jak je možné integrovat Expressive do existující aplikace a využít její modelovou vrstvu.

1. PSR-15 Middleware in Minutes
Zend Expressive
FB facebook.com/peckadesign TW @peckadesignZend Expressive Jan Kadeřábek

2. PSR-7: HTTP message interfaces
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek
• abstrakce nad HTTP zprávami
• sada interfaců v PsrHttpMessage
• https://www.php-fig.org/psr/psr-7/

3. PSR-7: HTTP message interfaces
• MessageInterface
•RequestInterface
•ServerRequestInterface
•ResponseInterface
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

4. PSR-15: HTTP Server Request Handlers
FB facebook.com/peckadesign TW @peckadesignZend Expressive Jan Kadeřábek
• Rozšiřuje PSR-7
• Zavádí:
• HTTP server request handler
• HTTP server middleware
• https://www.php-fig.org/psr/psr-15/

5. PSR-15: Request Handlers
• Zpracovává předaný request
• Vždy vrací response nebo vyhodí výjimku
• PsrHttpServerRequestHandlerInterface
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

6. PSR-15: Request Handlers
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

7. PSR-15: Middleware
• Zpracovává příchozí request a buď:
•Vrátí response
•Deleguje zpracování na další vrstvu
• PsrHttpServerMiddlewareInterface
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

8. PSR-15: Middleware
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

9. PSR-15: Middleware
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

10. PSR-15: Generating response
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek
• Každý handler nebo middleware který
generuje odpověd by měl sestavit instanci
ResponseInterface nebo továrnu, která je
shopna ji vytvořit

11. PSR-15: Handling exceptions
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek
• Existuje komponenta (middleware), která chytá
výjimky a převádí je na response
• Obaluje veškerý proces v aplikaci

12. PSR-15: Handling exceptions

13. Zend Expressive
FB facebook.com/peckadesign TW @peckadesignZend Expressive Jan Kadeřábek
• Minimalistický PSR-15 PHP framework
• Umí nic a zároveň vše
• Snadno konfigurovatelný
• Průhledná a jednoduchá implementace
• https://docs.zendframework.com/zend-expressive/

14. Routing
• Expressive nenabízí žádný defaultní router
• Pouze adaptéry integrující nějakou implementace routeru
• Aura.Router
• FastRoute
• zend-mvc Router
• ZendExpressiveRouterRouterInterface
• integrujte si svůj vlastní router
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

15. Routing

16. Dependency injection
• Expressive nenabízí žádný defaultní DI container
• PSR-11
•PsrContainerContainerInterface
• Opět tři základní balíčky
•zend-servicemanager
•pimple-interop
•aura.di
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

17. Templating
• Expressive nenabízí žádný defaultní templatovací engine
• Vhodné na API
•Vracím pouze ZendDiactorosResponseJsonResponse
• Šablony použiju jenom když potřebuju
•ZendExpressiveTemplateTemplateRendererInterface
• Handlery a middleware nejsou závislé na konkrétním enginu
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

18. Templating

19. Templating
• Plates
• Twig
• zend-view

20. Error handling
• Vyhazovat výjimky a mít vrstvu která je bude odchytávat
• Upravený PHP error_reporting
• ZendStratigilityMiddlewareErrorHandler
• Whoops error handler pro vývoj
• Detailní informace o chybě jako v Tracy
• Možnost konfigurace výstup (HTML, JSON)
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

22. FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

23. Piping

24. Co nám to umožňuje?
FB facebook.com/peckadesign TW @peckadesignZend Expressive Jan Kadeřábek
• Vytvořit pěknou validaci a mapování requestů
• Možnost si snadno sestavit aplikaci pro:
•Jednoduché E2E testování
•Integraci do existující aplikace

25. Validace příchozích requestů
FB facebook.com/peckadesign TW @peckadesignZend Expressive Jan Kadeřábek
• Kontrolovat data v requestu
• Standardizovaná odpověd API v případě chyby
• Mapovat data na pěkné DTO

26. Cíl
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

27. Symfony Validator
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

30. A v případě nevalidních dat?
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

32. Error response
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

33. Výsledek
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

34. Mapování přímo z routeru?
FB facebook.com/peckadesign TW @peckadesignZend Expressive Jan Kadeřábek
• V definici routy určit mapovaný objekt
• Handler nebo middleware už by dostal rovnou objekt requestu

35. Definice typu requestu
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

36. Použití v handleru
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

37. Konfigurovatelný middleware

38. Testování
FB facebook.com/peckadesign TW @peckadesignZend Expressive Jan Kadeřábek
• Unit testy na handlery
• E2E testy
•Spuštění celé aplikace bez posílání HTTP requestů díky PSR-7 abstrakci

39. Unit testy

40. E2E testy
• Poslat HTTP request a kontrolovat response
• Testuje navíc:
•zadefinované routy
•sestavení aplikace
•správně předané závislosti
•kombinaci jednotlivých komponent
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

41. E2E testy bez HTTP protokolu
• Využijeme abstrakce PSR-7
• PHPUnit
• Sestavíme aplikaci (instance Application)
•Předáme instanci ServerRequestInterface
•Spustíme aplikaci
•Zkontrolujeme vytvořenou instanci ResponseInterface
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

42. Abstraktní TestCase třída
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

43. Sestavení aplikace

44. Sestavení aplikace

45. Testovací databáze

46. Vytvoření requestu

47. Zaslání requestu

48. Rozbalení response

49. Výsledný test
FB facebook.com/peckadesign TW peckadesignZend Expressive Jan Kadeřábek

51. Zamyšlení na závěr
FB facebook.com/peckadesign TW @peckadesignZend Expressive Jan Kadeřábek
• Soustředím se pouze na jeden oddělený problém
•Ostatní deleguji dál
• Framework je pouze obálka, která drží pohromadě jednotlivé komponenty
•Dispatcher handlerů
• Je MVC přežitek?

52. FB facebook.com/peckadesign TW @peckadesign
Děkuji za pozornost
Zend Expressive Jan Kadeřábek
https://github.com/jankaderabek/expressive-playground