kicking off with zend expressive and doctrine orm (confoo yvr 2017)

@asgrim

Kicking off with Zend Expressiveand Doctrine ORM

James TitcumbConFoo 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-7HTTP 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


Expressive

Stratigility

Diactoros

PSR-7 Interface

DIRouter Template

Your Application

@asgrim

Zend DiactorosPSR-7 implementation

@asgrim

Node http.Server using Diactoros

$server = \Zend\Diactoros\Server::createServer(

function ($request, $response, $done) {

return $response->getBody()->write('hello world');

},

$_SERVER,

$_GET,

$_POST,

$_COOKIE,

$_FILES

);

$server->listen();

@asgrim


Expressive

Stratigility

Diactoros

PSR-7 Interface

DIRouter Template

Your Application

@asgrim

Zend StratigilityCreating & 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 App\Middleware;

use Interop\Http\ServerMiddleware\DelegateInterface;

use Interop\Http\ServerMiddleware\MiddlewareInterface;

use Psr\Http\Message\ResponseInterface;

use Psr\Http\Message\ServerRequestInterface;

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 \Zend\Stratigility\MiddlewarePipe();

$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


Expressive

Stratigility

Diactoros

PSR-7 Interface

DIRouter Template

Your Application

@asgrim

Zend ExpressiveOne Ring to bring them all and in the darkness bind them.

@asgrim

Routing

@asgrim

container-interop

@asgrim

Optionally, templating

@asgrim

Piping and Routing

@asgrim

Zend Framework 2/3What of them?

@asgrim

Middleware vs MVC

@asgrim

Using ZF componentsin Expressive

@asgrim

Module.php

class Module

{

public function getConfig()

{

return include __DIR__ . '/../config/module.config.php';

}

}

@asgrim

ConfigProvider

@asgrim

ConfigProvider

namespace Zend\Form;

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' => [

'Zend\Form\Annotation\FormAnnotationBuilder' => 'FormAnnotationBuilder',

Annotation\AnnotationBuilder::class => 'FormAnnotationBuilder',

FormElementManager::class => 'FormElementManager',

],

'factories' => [

'FormAnnotationBuilder' => Annotation\AnnotationBuilderFactory::class,

'FormElementManager' => FormElementManagerFactory::class,

],

@asgrim

Zend\Form’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 \Zend\Form\ConfigProvider())->__invoke();

@asgrim


Expressive

Stratigility

Diactoros

PSR-7 Interface

DIRouter Template

Your Application

@asgrim

Getting startedwith Zend Expressive

@asgrim

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

@asgrim

Expressive Skeleton

@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

> ExpressiveInstaller\OptionalPackages::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 structurezend-config-aggregator

@asgrim

Flat or Modular?

@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

Create the endpoints

@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 \App\Entity\Exception\BookNotAvailable

*/

public function checkOut()

{

if (!$this->inStock) {

throw Exception\BookNotAvailable::fromBook($this);

}

$this->inStock = false;

}

@asgrim

Book entity

class Book

{

/**

* @return void

* @throws \App\Entity\Exception\BookAlreadyStocked

*/

public function checkIn()

{

if ($this->inStock) {

throw Exception\BookAlreadyStocked::fromBook($this);

}

$this->inStock = true;

}

@asgrim

FindBookByUuidInterface

interface FindBookByUuidInterface

{

/**

* @param UuidInterface $slug

* @return Book

* @throws Exception\BookNotFound

*/

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' => [

App\Middleware\ErrorCatchingMiddleware::class,

ApplicationFactory::ROUTING_MIDDLEWARE,

Helper\UrlHelperMiddleware::class,

PSR7Sessions\Storageless\Http\SessionMiddleware::class,

App\Middleware\AuthenticationMiddleware::class,

ApplicationFactory::DISPATCH_MIDDLEWARE,

],

'priority' => 1,

],

@asgrim

Config vs Programmatic Pipe

$app->pipe(\App\Middleware\ErrorCatchingMiddleware::class);

$app->pipeRoutingMiddleware();

$app->pipe(\Zend\Expressive\Helper\UrlHelperMiddleware::class);

$app->pipe(\PSR7Sessions\Storageless\Http\SessionMiddleware::class);

$app->pipe(\App\Middleware\AuthenticationMiddleware::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' => App\Action\CheckOutAction::class, 'allowed_methods' => ['GET'], ], [ 'name' => 'check-in', 'path' => '/book/{id}/check-in', 'middleware' => App\Action\CheckInAction::class, 'allowed_methods' => ['GET'], ], ], ]; }

@asgrim

Injecting config into programmatic pipeline

$app->injectRoutesFromConfig((new BookRoutesConfigProvider())());

$app->injectPipelineFromConfig((new BookPipelineConfigProvider())());

@asgrim

Adding some ORM

@asgrim

Your application

Doctrine quick overview

DBDBAL 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 Doctrine\ORM\EntityManagerInterface;

use ContainerInteropDoctrine\EntityManagerFactory;

return [

'dependencies' => [

'factories' => [

EntityManagerInterface::class => EntityManagerFactory::class,

],

],

];

@asgrim

'doctrine' => [

'connection' => [

'orm_default' => [

'driver_class' => PDOPgSql\Driver::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 Doctrine\ORM\EntityManagerInterface;

use Doctrine\ORM\Tools\Console\Helper\EntityManagerHelper;

use Symfony\Component\Console\Helper\HelperSet;

$container = require __DIR__ . '/container.php';

return new HelperSet([

'em' => new EntityManagerHelper(

$container->get(EntityManagerInterface::class)

),

]);

config/cli-config.php

@asgrim

Annotating the Entities

@asgrim

/**

* @ORM\Entity

* @ORM\Table(name="book")

*/

class Book

{

/**

* @ORM\Id

* @ORM\Column(name="id", type="guid")

* @ORM\GeneratedValue(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 Exception\BookNotFound::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 \Zend\Expressive\Application $app */

$app->pipe(\Zend\Stratigility\Middleware\OriginalMessages::class);

$app->pipe(\Zend\Stratigility\Middleware\ErrorHandler::class);

$app->pipe(\Zend\Expressive\Helper\ServerUrlMiddleware::class);



$app->pipe(\App\Middleware\FlushingMiddleware::class);

$app->pipe(\Zend\Expressive\Middleware\ImplicitHeadMiddleware::class);

$app->pipe(\Zend\Expressive\Middleware\ImplicitOptionsMiddleware::class);





$app->pipe(\Zend\Expressive\Middleware\NotFoundHandler::class);

@asgrim

Doing more with middleware

@asgrim

Authentication

@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

Helioscomposer require dasprid/helios

@asgrim

PSR7-Sessioncomposer 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 Signer\Hmac\Sha256(),

$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 \Zend\Expressive\Application $app */

$app->pipe(\Zend\Stratigility\Middleware\OriginalMessages::class);

$app->pipe(\Zend\Stratigility\Middleware\ErrorHandler::class);

$app->pipe(\Zend\Expressive\Helper\ServerUrlMiddleware::class);



$app->pipe(\App\Middleware\FlushingMiddleware::class);

$app->pipe(\Zend\Expressive\Middleware\ImplicitHeadMiddleware::class);

$app->pipe(\Zend\Expressive\Middleware\ImplicitOptionsMiddleware::class);





$app->pipe(\Zend\Expressive\Middleware\NotFoundHandler::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

$skills++;

@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/

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)

Technology