twc/bus-bundle

Provide simple way to implement Message Bus concept in Symfony 4

v1.1.1 2021-07-16 06:21 UTC

Requires

• php: ^7.1
• symfony/dependency-injection: ^4.4|^5.3
• symfony/framework-bundle: ^4.4|^5.3

MIT

• Julien T. (TheWalkingCoder)

• symfony
• php
• cqrs
• command bus
• domain events
• message bus
• cqs
• Symfony 4
• symfony 5

README

Provide simple way to implement Message Bus concept in Symfony.

Before start

Thank's @lilobase for you excellent talk at PHP TOUR 2018.

Thank's @matGiWeb for you approach with cqrs-skeleton

Remember

CQRS (Command Query Responsibility Segregation) it's an architectural pattern that aims to separate the writing (Command) and reading (Query).

Pré-requis

symfony powerfull DI with autowire and autoconfigure enable

services:

    # default configuration for services in *this* file
    _defaults:
        autowire: true      # Automatically injects dependencies in your services.
        autoconfigure: true # Automatically registers your services as commands, event subscribers, etc.
        public: false

Installation

composer require twc/bus-bundle

How to use ?

If you know CQRS pattern, you only have to implement the desired interface

About Commands

topic	Interface
Command	Twc\BusBundle\Command\Interfaces\Command
CommandHandler	Twc\BusBundle\Command\Interfaces\CommandHandler
Middleware	Twc\BusBundle\Command\Interfaces\CommandBusMiddleware

About Events

topic	Interface
Event	Twc\BusBundle\Event\Interfaces\Event
EventHandler	Twc\BusBundle\Event\Interfaces\EventHandler

About Queries

topic	Interface
Query	Twc\BusBundle\Query\Interfaces\Query
QueryHandler	Twc\BusBundle\Event\Interfaces\QueryHandler

About Bus

topic	Interface
CommandBusDispatcher	Twc\BusBundle\Command\CommandBusDispatcher
EventBusDispatcher	Twc\BusBundle\Event\EventBusDispatcher
QueryBusDispatcher	Twc\BusBundle\Query\QueryBusDispatcher

That's all !

CommandBus, EventBus, QueryBus will do the work, thank's Dependencies Injection and autowiring in symfony.

Samples

• exemple (fr)