Kicking off with Zend Expressive and Doctrine ORM (ConFoo YVR 2017)

@asgrim
Kicking off with Zend Expressive
and Doctrine ORM
James Titcumb
ConFoo Vancouver 2017
Follow along (optional): https://github.com/asgrim/book-library

$ whoami
James Titcumb
www.jamestitcumb.com
www.roave.com
@asgrim

@asgrim
What is Zend Expressive?

@asgrim
Layers of an Expressive application
Expressive
Stratigility
Diactoros
PSR-7 Interface
DIRouter Template
Your Application

@asgrim
PSR-7
HTTP Message Interfaces

@asgrim
HTTP Request
POST /yvr2017/foo HTTP/1.1
Host: confoo.ca
foo=bar&baz=bat

@asgrim
HTTP Response
HTTP/1.1 200 OK
Content-Type: text/plain
This is the response body

@asgrim
Zend Diactoros
PSR-7 implementation

@asgrim
Node http.Server using Diactoros
$server = ZendDiactorosServer::createServer(
function ($request, $response, $done) {
return $response->getBody()->write('hello world');
},
$_SERVER,
$_GET,
$_POST,
$_COOKIE,
$_FILES
);
$server->listen();

@asgrim
Zend Stratigility
Creating & dispatching middleware pipelines

@asgrim
So what is “middleware”?

@asgrim
Middleware in the middle
function(Request $request, DelegateInterface $delegate) : Response
{
// ... some code before ...
$response = $delegate->process($request);
// ... some code after ...
return $response;
}

@asgrim
Some people call it an onion
SessionInitialisingMiddleware
AuthenticationMiddleware
ThingyMiddleware
DashboardAction

@asgrim
http-interop/http-middleware
(work in progress)

@asgrim
Middleware using MiddlewareInterface
<?php
declare(strict_types=1);
namespace AppMiddleware;
use InteropHttpServerMiddlewareDelegateInterface;
use InteropHttpServerMiddlewareMiddlewareInterface;
use PsrHttpMessageResponseInterface;
use PsrHttpMessageServerRequestInterface;
final class MyMiddleware implements MiddlewareInterface
{
public function process(
ServerRequestInterface $request,
DelegateInterface $delegate
) : ResponseInterface {
return $delegate->process($request);
}
}

@asgrim
Double-pass middleware
public function __invoke(
Request $request,
Response $response,
callable $next
): Response {
return $next($request, $response);
}
!!! DEPRECATED !!!

@asgrim
Modifying the response
{
return $response->withHeader(
'X-Clacks-Overhead',
'GNU Terry Pratchett'
);
}

@asgrim
Pipe all the things!
$pipe = new ZendStratigilityMiddlewarePipe();
$pipe->pipe($logUncaughtErrorsMiddleware);
$pipe->pipe($sessionInitialisingMiddleware);
$pipe->pipe($authenticationMiddleware);
$pipe->pipe('/', $indexActionMiddleware);
$pipe->pipe(new NotFoundHandler(...));

@asgrim
LogErrorsCaughtMiddleware
{
try {
} catch (Throwable $throwable) {
// Log the error, handle it with error page etc.
return new JsonResponse(
[
'message' => $throwable->getMessage(),
],
500
);
}
}

@asgrim
SessionInitialisingMiddleware
{
session_start();
}

@asgrim
{
if (!$this->doSomeOAuthCheck($request)) {
return new JsonResponse(
[
'message' => 'Invalid OAuth token',
],
403
);
}
}
AuthenticationMiddleware

@asgrim
IndexActionMiddleware
{
// ... some code ...
return new JsonResponse($someData, 200);
}

@asgrim
Zend Expressive
One Ring to bring them all and in the darkness bind them.

@asgrim
Optionally, templating

@asgrim
Zend Framework 2/3
What of them?

@asgrim
Using ZF components
in Expressive

@asgrim
Module.php
class Module
{
public function getConfig()
{
return include __DIR__ . '/../config/module.config.php';
}
}

@asgrim
ConfigProvider
namespace ZendForm;
class ConfigProvider
{
public function __invoke()
{
return [
'dependencies' => $this->getDependencyConfig(),
'view_helpers' => $this->getViewHelperConfig(),
];
}
}

@asgrim
ConfigProvider#getDependencyConfig()
public function getDependencyConfig()
{
return [
'abstract_factories' => [
FormAbstractServiceFactory::class,
],
'aliases' => [
'ZendFormAnnotationFormAnnotationBuilder' => 'FormAnnotationBuilder',
AnnotationAnnotationBuilder::class => 'FormAnnotationBuilder',
FormElementManager::class => 'FormElementManager',
],
'factories' => [
'FormAnnotationBuilder' => AnnotationAnnotationBuilderFactory::class,
'FormElementManager' => FormElementManagerFactory::class,
],

@asgrim
ZendForm’s Module.php (for Zend Framework)
class Module
{
public function getConfig()
{
$provider = new ConfigProvider();
return [
'service_manager' => $provider->getDependencyConfig(),
'view_helpers' => $provider->getViewHelperConfig(),
];
}
}

@asgrim
config/autoload/zend-form.global.php
<?php
return (new ZendFormConfigProvider())->__invoke();

@asgrim
Getting started
with Zend Expressive

@asgrim
https://github.com/asgrim/book-library

@asgrim
Expressive installer - start
$ composer create-project zendframework/zend-expressive-skeleton book-library
Installing zendframework/zend-expressive-skeleton (2.0.4)
- Installing zendframework/zend-expressive-skeleton (2.0.4): Downloading (100%)
Created project in book-library-2
> ExpressiveInstallerOptionalPackages::install
Setting up optional packages
Setup data and cache dir
Removing installer development dependencies

@asgrim
Expressive installer - structure
What type of installation would you like?
[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)
Make your selection (2):

@asgrim
Modular structure
zend-config-aggregator

@asgrim
Default modular structure
src/
MyModule/
src/
ConfigProvider.php
Action/
Entity/
Middleware/
templates/
test/

@asgrim
Expressive installer - container?
Which container do you want to use for dependency injection?
[1] Aura.Di
[2] Pimple
[3] Zend ServiceManager
Make your selection or type a composer package name and version (Zend ServiceManager):

@asgrim
Expressive installer - router?
Which router do you want to use?
[1] Aura.Router
[2] FastRoute
[3] Zend Router
Make your selection or type a composer package name and version (FastRoute):

@asgrim
Expressive installer - template?
Which template engine do you want to use?
[1] Plates
[2] Twig
[3] Zend View installs Zend ServiceManager
[n] None of the above
Make your selection or type a composer package name and version (n):

@asgrim
Expressive installer - whoops?
Which error handler do you want to use during development?
[1] Whoops
[n] None of the above
Make your selection or type a composer package name and version (Whoops):

@asgrim
Expressive installer - run it!
$ composer serve
> php -S 0.0.0.0:8080 -t public/ public/index.php
[Thu Sep 1 20:29:33 2016] 127.0.0.1:48670 [200]: /favicon.ico
{
"welcome": "Congratulations! You have installed the zend-expressive skeleton application.",
"docsUrl": "https://docs.zendframework.com/zend-expressive/"
}

@asgrim
Book entity
class Book
{
/**
* @var string
*/
private $id;
/**
* @var bool
*/
private $inStock = true;
public function __construct()
{
$this->id = (string)Uuid::uuid4();
}

@asgrim
Book entity
class Book
{
/**
* @return void
* @throws AppEntityExceptionBookNotAvailable
*/
public function checkOut()
{
if (!$this->inStock) {
throw ExceptionBookNotAvailable::fromBook($this);
}
$this->inStock = false;
}

@asgrim
Book entity
class Book
{
/**
* @return void
* @throws AppEntityExceptionBookAlreadyStocked
*/
public function checkIn()
{
if ($this->inStock) {
throw ExceptionBookAlreadyStocked::fromBook($this);
}
$this->inStock = true;
}

@asgrim
FindBookByUuidInterface
interface FindBookByUuidInterface
{
/**
* @param UuidInterface $slug
* @return Book
* @throws ExceptionBookNotFound
*/
public function __invoke(UuidInterface $slug): Book;
}

@asgrim
CheckOutAction
public function process(ServerRequestInterface $request, DelegateInterface $delegate): JsonResponse
{
try {
$book = $this->findBookByUuid->__invoke(Uuid::fromString($request->getAttribute('id')));
} catch (BookNotFound $bookNotFound) {
return new JsonResponse(['info' => $bookNotFound->getMessage()], 404);
}
try {
$book->checkOut();
} catch (BookNotAvailable $bookNotAvailable) {
return new JsonResponse(['info' => $bookNotAvailable->getMessage()], 423);
}
return new JsonResponse([
'info' => sprintf('You have checked out %s', $book->getId()),
]);
}

@asgrim
Config vs Programmatic Pipe
'middleware_pipeline' => [
'routing' => [
'middleware' => [
AppMiddlewareErrorCatchingMiddleware::class,
ApplicationFactory::ROUTING_MIDDLEWARE,
HelperUrlHelperMiddleware::class,
PSR7SessionsStoragelessHttpSessionMiddleware::class,
AppMiddlewareAuthenticationMiddleware::class,
ApplicationFactory::DISPATCH_MIDDLEWARE,
],
'priority' => 1,
],

@asgrim
Config vs Programmatic Pipe
$app->pipe(AppMiddlewareErrorCatchingMiddleware::class);
$app->pipeRoutingMiddleware();
$app->pipe(ZendExpressiveHelperUrlHelperMiddleware::class);
$app->pipe(PSR7SessionsStoragelessHttpSessionMiddleware::class);
$app->pipe(AppMiddlewareAuthenticationMiddleware::class);
$app->pipeDispatchMiddleware();

@asgrim
Injecting config into programmatic pipeline
final class BookRoutesConfigProvider
{
public function __invoke()
{
return [
'routes' => [
[
'name' => 'check-out',
'path' => '/book/{id}/check-out',
'middleware' => AppActionCheckOutAction::class,
'allowed_methods' => ['GET'],
],
[
'name' => 'check-in',
'path' => '/book/{id}/check-in',
'middleware' => AppActionCheckInAction::class,
'allowed_methods' => ['GET'],
],
],
];
}

@asgrim
Injecting config into programmatic pipeline
$app->injectRoutesFromConfig((new BookRoutesConfigProvider())());
$app->injectPipelineFromConfig((new BookPipelineConfigProvider())());

@asgrim
Your application
Doctrine quick overview
DB
DBAL
ORM
(EntityManager)
Entities
Finders,
Services,
...

@asgrim
container-interop-doctrine

@asgrim
Installation
$ composer require dasprid/container-interop-doctrine
Using version ^1.0 for dasprid/container-interop-doctrine
./composer.json has been updated
Loading composer repositories with package information
Updating dependencies (including require-dev)
Package operations: 1 install, 0 updates, 0 removals
- Installing dasprid/container-interop-doctrine (1.0.0): Loading from cache
Package http-interop/http-middleware is abandoned, you should avoid using it.
Use http-interop/http-server-middleware instead.
Writing lock file
Generating autoload files
$

@asgrim
config/autoload/doctrine.global.php
<?php
declare(strict_types = 1);
use DoctrineORMEntityManagerInterface;
use ContainerInteropDoctrineEntityManagerFactory;
return [
'dependencies' => [
'factories' => [
EntityManagerInterface::class => EntityManagerFactory::class,
],
],
];

@asgrim
'doctrine' => [
'connection' => [
'orm_default' => [
'driver_class' => PDOPgSqlDriver::class,
'params' => [
'url' => 'postgres://user:pass@localhost/book_library',
],
],
],
'driver' => [
'orm_default' => [
'class' => MappingDriverChain::class,
'drivers' => [
// ... and so on ...
config/autoload/doctrine.global.php

@asgrim
<?php
declare(strict_types = 1);
use DoctrineORMEntityManagerInterface;
use DoctrineORMToolsConsoleHelperEntityManagerHelper;
use SymfonyComponentConsoleHelperHelperSet;
$container = require __DIR__ . '/container.php';
return new HelperSet([
'em' => new EntityManagerHelper(
$container->get(EntityManagerInterface::class)
),
]);
config/cli-config.php

@asgrim
Annotating the Entities

@asgrim
/**
* @ORMEntity
* @ORMTable(name="book")
*/
class Book
{
/**
* @ORMId
* @ORMColumn(name="id", type="guid")
* @ORMGeneratedValue(strategy="NONE")
* @var string
*/
private $id;
src/App/Entity/Book.php

@asgrim
public function __invoke(UuidInterface $id): Book
{
/** @var Book|null $book */
$book = $this->repository->find((string)$id);
if (null === $book) {
throw ExceptionBookNotFound::fromUuid($id);
}
return $book;
}
src/App/Service/Book/DoctrineFindBookByUuid.php

@asgrim
try {
$this->entityManager->transactional(function () use ($book) {
$book->checkOut();
});
} catch (BookNotAvailable $bookNotAvailable) {
return new JsonResponse(['info' => $bookNotAvailable->getMessage()], 423);
}
src/App/Action/CheckOutAction.php

@asgrim
Generate the schema
$ vendor/bin/doctrine orm:schema-tool:create
ATTENTION: This operation should not be executed in a production
environment.
Creating database schema...
Database schema created successfully!
$

@asgrim
Insert some data
INSERT INTO book (id, name, in_stock) VALUES (
'1c06bec9-adae-47c2-b411-73b1db850e6f',
'The Great Escape',
true
);

@asgrim
/book/1c06bec9-adae-47c2-b411-.../check-out
{"info":"You have checked out The Great Escape"}

@asgrim
/book/1c06bec9-adae-47c2-b411-.../check-in
{"info":"You have checked in The Great Escape"}

@asgrim
Automatic Flushing Middleware

@asgrim
FlushingMiddleware
public function process(Request $request, DelegateInterface $delegate)
{
if ($this->entityManager->isOpen()) {
$this->entityManager->flush();
}
return $response;
}

@asgrim
Add to pipeline
/** @var ZendExpressiveApplication $app */
$app->pipe(ZendStratigilityMiddlewareOriginalMessages::class);
$app->pipe(ZendStratigilityMiddlewareErrorHandler::class);
$app->pipe(ZendExpressiveHelperServerUrlMiddleware::class);
$app->pipe(AppMiddlewareFlushingMiddleware::class);
$app->pipe(ZendExpressiveMiddlewareImplicitHeadMiddleware::class);
$app->pipe(ZendExpressiveMiddlewareImplicitOptionsMiddleware::class);
$app->pipe(ZendExpressiveMiddlewareNotFoundHandler::class);

@asgrim
Doing more with
middleware

@asgrim
public function process(
ServerRequestInterface $request,
DelegateInterface $delegate
) : Response {
$queryParams = $request->getQueryParams();
// DO NOT DO THIS IN REAL LIFE
// It's really not secure ;)
if (!array_key_exists('authenticated', $queryParams)
|| $queryParams['authenticated'] !== '1') {
return new JsonResponse(['error' => 'You are not authenticated.'], 403);
}
}
Create the middleware

@asgrim
Helios
composer require dasprid/helios

@asgrim
PSR7-Session
composer require psr7-sessions/storageless

@asgrim
public function __invoke(ContainerInterface $container, $_, array $_ = null)
{
$symmetricKey = 'do-not-store-this-key-in-git-store-it-in-configuration-instead-please';
$expirationTime = 1200; // 20 minutes
return new SessionMiddleware(
new SignerHmacSha256(),
$symmetricKey,
$symmetricKey,
SetCookie::create(SessionMiddleware::DEFAULT_COOKIE)
->withSecure(false) // false on purpose, unless you have https locally
->withHttpOnly(true)
->withPath('/'),
new Parser(),
$expirationTime,
new SystemCurrentTime()
);
}
Factory the middleware

@asgrim
/** @var ZendExpressiveApplication $app */
$app->pipe(ZendStratigilityMiddlewareOriginalMessages::class);
$app->pipe(ZendStratigilityMiddlewareErrorHandler::class);
$app->pipe(ZendExpressiveHelperServerUrlMiddleware::class);
$app->pipe(AppMiddlewareFlushingMiddleware::class);
$app->pipe(ZendExpressiveMiddlewareImplicitHeadMiddleware::class);
$app->pipe(ZendExpressiveMiddlewareImplicitOptionsMiddleware::class);
$app->pipe(ZendExpressiveMiddlewareNotFoundHandler::class);
Add middleware to pipe

@asgrim
$session = $request->getAttribute(SessionMiddleware::SESSION_ATTRIBUTE);
$session->set('counter', $session->get('counter', 0) + 1);
Session is stored in Request

@asgrim
To summarise...
● PSR-7 is the foundation for this!
● Diactoros is just a PSR-7 implementation
● Stratigility is a middleware pipeline: the main bit
● Expressive is a glue for everything
● DoctrineModule can be used (with some fiddling)
● container-interop-doctrine makes Doctrine work easier
● Middleware all the things!
● Similar concepts in other frameworks (e.g. Slim)

@asgrim
Useful references
● https://github.com/asgrim/book-library
● https://framework.zend.com/blog/2017-03-13-expressive-2-migration.html
● https://framework.zend.com/blog/2017-03-30-expressive-config-routes.html
● https://mwop.net/blog/2016-05-16-programmatic-expressive.html
● https://docs.zendframework.com/zend-expressive/
● https://docs.zendframework.com/zend-expressive/cookbook/autowiring-routes-and-pipelines/
● https://docs.zendframework.com/zend-expressive/cookbook/passing-data-between-middleware/
● http://www.masterzendframework.com/zend-expressive-introduction/

Any questions?
James Titcumb
@asgrim

Kicking off with Zend Expressive and Doctrine ORM (ConFoo YVR 2017)

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to Kicking off with Zend Expressive and Doctrine ORM (ConFoo YVR 2017)

Similar to Kicking off with Zend Expressive and Doctrine ORM (ConFoo YVR 2017) (20)

More from James Titcumb

More from James Titcumb (16)

Recently uploaded

Recently uploaded (20)

Kicking off with Zend Expressive and Doctrine ORM (ConFoo YVR 2017)