∙ ∙ in Symfony ∙

architectural patterns

needs they do

it depends™

wait

don't

!==

belongs to

tools responsibility well fault

not the end

library

don't *

Symfony ?

good boy framework!

clear responsibility boundaries

supports

like a framework

forget included in PHP SPL

information flow the architecture

composer create-project symfony/skeleton .

├── bin │ └── console ├── composer.json ├── composer.lock ├── config │ ├── bootstrap.php │ ├── bundles.php │ ├── packages │ │ ├── cache.yaml │ │ ├── dev │ │ │ └── routing.yaml │ │ ├── framework.yaml │ │ ├── routing.yaml │ │ └── test │ │ ├── framework.yaml │ │ └── routing.yaml │ ├── routes.yaml │ └── services.yaml ├── public │ └── index.php ├── src │ ├── Controller │ └── Kernel.php ├── symfony.lock ├── var └── vendor

├── bin │ └── console ├── composer.json ├── composer.lock ├── config │ ├── bootstrap.php │ ├── bundles.php │ ├── packages │ │ ├── cache.yaml │ │ ├── dev │ │ │ └── routing.yaml │ │ ├── framework.yaml │ │ ├── routing.yaml │ │ └── test │ │ ├── framework.yaml │ │ └── routing.yaml │ ├── routes.yaml │ └── services.yaml ├── public │ └── index.php ├── src │ ├── Controller │ └── Kernel.php ├── symfony.lock ├── var └── vendor

└── src ├── Controller └── Kernel.php

No content

└── src ├── Command │ └── GenerateCommand.php ├── Controller │ ├── UserController.php │ └── CarController.php ├── Entity │ ├── User.php │ └── Car.php ├── Form │ ├── UserType.php │ └── CarType.php ├── Manager │ ├── UserManager.php │ └── CarManager.php ├── Repository │ ├── UserRepository.php │ └── CarRepository.php ├── Security │ └── Voter │ ├── UserVoter.php │ └── CarVoter.php ├── Service │ ├── UserService.php │ └── CarService.php └── Kernel.php

└── src ├── Command │ └── GenerateCommand.php ├── Controller │ ├── UserController.php │ └── CarController.php ├── Entity │ ├── User.php │ └── Car.php ├── Form │ ├── UserType.php │ └── CarType.php ├── Manager │ ├── UserManager.php │ └── CarManager.php ├── Repository │ ├── UserRepository.php │ └── CarRepository.php ├── Security │ └── Voter │ ├── UserVoter.php │ └── CarVoter.php ├── Service │ ├── UserService.php │ └── CarService.php └── Kernel.php

not guilty

extremely simplified architectural approaches

ports adapters

CQRS

Domain Driven Design

Event Sourcing

src └── Shared └── Infrastructure └── SymfonyKernel.php

src ├── Account │ ├── Application │ ├── Domain │ └── Infrastructure └── Shared ├── Application ├── Domain └── Infrastructure └── SymfonyKernel.php

src ├── Account │ ├── Application │ ├── Domain │ └── Infrastructure └── Shared ├── Application │ └── CommandInterface.php ├── Domain └── Infrastructure ├── SynchronousCommandBus.php ├── CommandBusInterface.php └── SymfonyKernel.php

interface CommandBusInterface { public function handle(CommandInterface $command): void; } final class SynchronousCommandBus implements CommandBusInterface { private $handlers; public function map(string $command, callable $handler): void { $this->handlers[$command] = $handler; } public function handle(CommandInterface $command): void { $fqcn = \get_class($command); $handlerNotFound = false === isset($this->handlers[$fqcn]); HandlerNotFoundException::throwWhen($handlerNotFound, $fqcn); call_user_func($this->handlers[$fqcn], $command); } }

src ├── Account │ ├── Application │ ├── Domain │ │ ├── Account.php │ │ └── AccountRepositoryInterface.php │ └── Infrastructure └── Shared ├── Application │ └── CommandInterface.php ├── Domain └── Infrastructure ├── SynchronousCommandBus.php ├── CommandBusInterface.php └── SymfonyKernel.php

interface AccountRepositoryInterface { public function findById(int $id): Account; } final class Account { /** @var int */ private $id; /** @var string */ private $email; public function __construct(int $id, string $email) { $this->id = $id; $this->email = $email; } }

src ├── Account │ ├── Application │ │ ├── AccountQueryInterface.php │ │ ├── SetupAccountCommand.php │ │ └── SetupAccountHandler.php │ ├── Domain │ │ ├── Account.php │ │ └── AccountRepositoryInterface.php │ └── Infrastructure └── Shared ├── Application │ └── CommandInterface.php ├── Domain └── Infrastructure ├── SynchronousCommandBus.php ├── CommandBusInterface.php └── SymfonyKernel.php

final class SetupAccountCommand implements CommandInterface { /** @var int */ private $id; /** @var string */ private $email; public function __construct(int $id, string $email) { $this->id = $id; $this->email = $email; } public function getId(): int { return $this->id; } public function getEmail(): string { return $this->email; } }

final class SetupAccountHandler { /** @var AccountRepositoryInterface */ private $accounts; public function __construct(AccountRepositoryInterface $accounts) { $this->accounts = $accounts; } public function __invoke(SetupAccountCommand $cmd) { $account = new Account($cmd->getId(), $cmd->getEmail()); $this->accounts->add($account); } }

interface AccountQueryInterface { public function findByEmail(EmailValue $email): AccountView; } final class AccountView { /** @var int */ public $id; /** @var string */ public $email; public function __construct(int $id, string $email) { $this->id = $id; $this->email = $email; } }

src ├── Account │ ├── Application │ │ ├── AccountQueryInterface.php │ │ ├── SetupAccountCommand.php │ │ └── SetupAccountHandler.php │ ├── Domain │ │ ├── Account.php │ │ └── AccountRepositoryInterface.php │ └── Infrastructure │ ├── AccountController.php │ ├── DoctrineDbalAccountQuery.php │ └── DoctrineOrmAccountRepository.php └── Shared ├── Application │ └── CommandInterface.php ├── Domain └── Infrastructure ├── SynchronousCommandBus.php ├── CommandBusInterface.php └── SymfonyKernel.php

final class DoctrineOrmAccountRepository implements AccountRepositoryInterface { /** @var EntityManagerInterface */ private $em; public function __construct(EntityManagerInterface $em) { $this->em = $em; } public function findById(int $id): Account { return $this->em->find(Account::class, $id); } }

final class DoctrineDbalAccountQuery implements AccountQueryInterface { /** @var Connection */ private $connection; public function __construct(Connection $connection) { $this->connection = $connection; } public function findByEmail(EmailValue $email): AccountView { $sql = 'SELECT id, email FROM user WHERE email = :email'; $data = $this->connection->exec($sql, ['email' => $email]); return new AccountView($data['id'], $data['email']); } }

final class AccountController { // ... public function __construct(CommandBusInterface $bus, RouterInterface $router) { // ... } public function setupAction(Request $request): Response { $id = generateId(); $payload = $request->request->all(); $command = new SetupAccountCommand($id, $payload['email']); $this->bus->handle($command); return new Response(null, Response::HTTP_CREATED, [ 'Location' => $this->router->generate('account.view', [$id]), ]); } }

Symfony?

account.setup: methods: [POST] path: /accounts controller: account.controller::setupAction

parameters: services: _defaults: autowire: true autoconfigure: true App\: resource: '../src/*' exclude: '../src/{DependencyInjection,Entity,Migrations,Tests,Kernel.php}' App\Controller\: resource: '../src/Controller' tags: ['controller.service_arguments']

services: _defaults: autowire: false autoconfigure: false public: false

account.query: class: Thunder\App\Account\Infrastructure\DoctrineDbalAccountQuery arguments: ['@doctrine.dbal.connection'] account.repository: class: Thunder\App\Account\Infrastructure\DoctrineOrmAccountRepository arguments: ['@doctrine.orm.entity_manager'] account.controller: class: Thunder\App\Account\Infrastructure\AccountController arguments: ['@command_bus', '@routing'] public: true

command_bus: class: Thunder\App\Shared\Infrastructure\SynchronousCommandBus arguments: [] calls: - ['map', ['Thunder\App\Account\Application\SetupAccountCommand','@account.setup.handler']] account.setup.handler: class: Thunder\App\Account\Application\AddAccountHandler arguments: ['@account.repository']

E S

src ├── Account │ ├── Application │ │ ├── AccountQueryInterface.php │ │ ├── SetupAccountCommand.php │ │ └── SetupAccountHandler.php │ ├── Domain │ │ ├── Account.php │ │ ├── AccountWasSetupEvent.php │ │ └── AccountRepositoryInterface.php │ └── Infrastructure │ ├── AccountController.php │ ├── DoctrineDbalAccountQuery.php │ └── DoctrineOrmAccountRepository.php └── Shared ├── Application │ └── CommandInterface.php ├── Domain └── Infrastructure ├── SynchronousCommandBus.php ├── CommandBusInterface.php └── SymfonyKernel.php

final class AccountWasSetupEvent { /** @var int */ private $id; /** @var string */ private $email; public function __construct(int $id, string $email) { $this->id = $id; $this->email = $email; } public function getId(): int { return $this->id; } public function getEmail(): string { return $this->email; } }

simple, eh?

simple !== easy

Any questions? ask

Resources https://murze.be/hexagonal-architecture https://fideloper.com/hexagonal-architecture https://stackoverflow.com/q/32216408/443341 https://www.slideshare.net/profpv/hexagonal-architecture-in-php https://matthiasnoback.nl/2017/08/layers-ports-and-adapters-part-2-layers https://enterprisecraftsmanship.com/2019/01/31/cqrs-commands-part-domain-model https://blog.octo.com/en/hexagonal-architecture-three-principles-and-an-implementation-example https://herbertograca.com/2017/11/16/explicit-architecture-01-ddd-hexagonal-onion-clean-cqrs-how-i-put-it-all-together/ https://apiumhub.com/tech-blog-barcelona/applying-hexagonal-architecture-symfony-project Images https://unsplash.com/photos/cjNaoIqbWCI (dog) https://unsplash.com/photos/6U-sSfBV-gM (city tower) https://unsplash.com/photos/aSCx7M1E4Vo (foggy forest) https://unsplash.com/photos/h0Vxgz5tyXA (wooden floor)

5 30 2 8 knowledge eternal glory Symfopardy! see you today at 17:00!

No content

No content

GENTLEMAN software with manners @tmmx

Thanks!