Simplify your application with a command bus SymfonyCon Cluj 2017

Romaric Drigon Software engineer @ netinfluence, Switzerland

What we want to avoid

How our code should feel like

What is a command bus? A command... "...an object is used to encapsulate all information needed to perform an action..." ...and a bus "...a communication system that transfers data between components..."

To wrap up...

A use case A Finder-like application in javascript On each file, you can operate commands: create a folder, rename a file, remove... Requests are sent from the JS application to a Symfony backend

Setting up a command bus We will use Tactician (https://tactician.thephpleague.com/) Developed by Ross Tuck A Symfony bundle is available Notable alternatives include SimpleBus, by Matthias Noback

A Command item = $item; } public function getItem(): Item { return $this->item; } }

The corresponding handler getItem(); $this->entityManager->remove($item); $this->entityManager->flush(); // We can find a better way return $item->getUuid(); // It can return a result! } }

Declaring the handler Declared as a Symfony service: Note: handlers now support autowiring, check out Tactician bundle documentation app.remove_handler: class: AppBundle\Handler\RemoveHandler tags: - { name: tactician.handler, command: AppBundle\Model\Command\RemoveComman arguments: - '@doctrine.orm.default_entity_manager'

Sending the command to the bus From the Symfony API controller: Great, Romaric... but what is the interest? /** * @ParamConverter("item") */ public function apiAction(Item $item) { $command = new RemoveCommand($item); $uuid = $this->get('tactician.commandbus')->handle($command); return new JsonResponse(['uuid' => $uuid]); }

It scales well!

The application is getting complex... After one month, we had 25 commands and handlers, totaling 3500 lines of code.

Adding middlewares Huge interest: middlewares help to simplify common tasks.

Middleware examples Doctrine (https://tactician.thephpleague.com/plugins/doctrine/) : wraps handlers in a DB transaction Logger (https://tactician.thephpleague.com/plugins/logger/) : can log everything to Monolog (audit!) Validation (shipped with Symfony Tactician bundle) Security, authorization ...

Going further Testing: handlers and middlewares are easier to unit test Commands could be sent to a message queue (RabbitMQ...) instead of staying in memory, or scheduled to be executed later (delayed task...).

romaric@netinfluence.ch http://blog.netinfluence.ch