v1.0.3 2017-04-15 09:54 UTC

This package is auto-updated.

Last update: 2022-04-29 00:47:56 UTC


Latest Stable Version Build Status License Total Downloads

Implicit routing a command to it's handler

A command is routed to the handler with the same name and "Handler" appended under the same namespace:

namespace Some\Space;

// your command
class Command {}

// your command handler 
class CommandHandler {
    function __invoke(Command $cmd) {...} 


By using conventions (implicit routing) you can easily add commands\queries without constant updating configuration files. Just put both files in the same folder and follow the name convention:

  • Handler class must be name exactly as a Command + Handler appended at the end
  • Both command and a handler must reside under the same namespace

Just a handy tool :)


composer require lezhnev74/prooph-direct-router


In case you use config files in your project, visit your prooph.php config file and update the "service_bus.command_bus.router.type" field. If you set up message bus manually, then scroll down to the "Usage" section.

'service_bus' => [
    'command_bus' => [
        'router' => [
            'routes' => [
                // list of commands with corresponding command handler
            'type' => \DirectRouter\DirectRouter::class


This package uses dependency-container to locate the handler for a given command, so you need to install some container package (which supports ContainerInterface)

// Manual message bus setup
// 1. Prepare router
$router = new DirectRouter();
// 2. Add service locator (to instantiate the handler). $container is your implementation of PSR-11 ContainerInterface
$locator = new ServiceLocatorPlugin($container);

// Dispatch command
$command = new \Some\Space\Command(...);