PHPackages                             vherus/depot - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. vherus/depot

ActiveLibrary[CLI & Console](/categories/cli)

vherus/depot
============

A simple PHP command bus

v1.0(9y ago)067MITPHPPHP >=7.0

Since Jan 18Pushed 7y ago1 watchersCompare

[ Source](https://github.com/Vherus/depot)[ Packagist](https://packagist.org/packages/vherus/depot)[ RSS](/packages/vherus-depot/feed)WikiDiscussions master Synced 4w ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

Depot - PHP Command Bus
=======================

[](#depot---php-command-bus)

[![Build Status](https://camo.githubusercontent.com/466e0b9aca3afcb2ad2a070baf30b549f9f7ae4ca3d538149ed295ae69f435b5/68747470733a2f2f7472617669732d63692e6f72672f5668657275732f6465706f742e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/Vherus/depot)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/1e0cafa3a71f0147898419f2c466b4e9e178da42d0888632e4d5da8465cc67c9/68747470733a2f2f7363727574696e697a65722d63692e636f6d2f672f5668657275732f6465706f742f6261646765732f7175616c6974792d73636f72652e706e673f623d6d6173746572)](https://scrutinizer-ci.com/g/Vherus/depot/?branch=master)

Install
-------

[](#install)

`composer require vherus/depot`

Usage
-----

[](#usage)

Out of the box, there are two ways to use Depot. You can either explicitly provide a map of commands `=>` handlers, or (my favourite) you can use the `NativeNamespaceResolver` to automatically resolve your handlers.

First, we'll look at the automatic resolver.

```
$bus = new Depot\Bus\NativeCommandBus(new Depot\Resolution\NativeNamespaceResolver);
$bus->dispatch(new My\Command);
```

The `NativeNamespaceResolver` will look in the commands current directory and a subdirectory of `Handler` and `Handlers` to try and resolve the correct handler for the given command. If it's unable to resolve it, it'll throw a `Depot\Exception\UnresolvableHandlerException`.

So all you need to do is create your command:

```
namespace My;

class Command implements Depot\Command { }
```

And a handler with the same name, suffixed with 'Handler', in either the current namespace or a sub-namespace named 'Handler' or 'Handlers'.

```
namespace My\Handler;

class CommandHandler
{
    public function handle(My\Command $command) { }
}
```

Alternatively, you can use the map resolver to be more explicit about your handler resolutions.

```
$bus = new NativeCommandBus(new NativeMapResolver([
    My\Command::class => My\Command\Handler\CommandHandler::class
]));
$bus->dispatch(new My\Command);
```

Decoration
----------

[](#decoration)

`Depot` does not come with any "decorators" out of the box; at least, not yet. However, since Depot is rather simple, it's very easy to decorate. You could, for example, create your own implementation of the Depot `CommandBus` interface and pass the provided `NativeCommandBus` into it.

For example:

```
class QueuedCommand extends Depot\Command {}

class QueuedCommandBus implements Depot\CommandBus
{
    private $innerBus;
    private $queue;

    public function __construct(Depot\CommandBus $innerBus, SomeQueueLibrary $queue)
    {
        $this->innerBus = $innerBus;
        $this->queue = $queue;
    }

    public function dispatch(Command $command)
    {
        if ($command instanceof QueuedCommand) {
            $this->queue->queue($command);
            return;
        }

        $this->innerBus->dispatch($command);
    }
}
```

Framework Specifics
-------------------

[](#framework-specifics)

### Laravel

[](#laravel)

I'm not in the habit of creating "ServiceProviders" and "Laravel Bridges" - I feel it's important that you be able to decide exactly how to use any given package. However, I have included an adapter for the Laravel IoC container.

To set up Depot with Laravel, you could simply add something like the below to your `AppServiceProvider`:

```
$this->app->bind(Depot\Container::class, Depot\Container\Laravel\IlluminateContainer::class);
$this->app->bind(Depot\HandlerResolver::class, Depot\Resolution\NativeNamespaceResolver::class);
$this->app->bind(Depot\CommandBus::class, Depot\Bus\NativeCommandBus::class);
```

This will allow you to go ahead an inject `Depot\CommandBus` as a dependency into your classes as normal.

Note: I have no intention of providing a "facade".

###  Health Score

26

—

LowBetter than 41% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3450d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/5518649?v=4)[Nathan King](/maintainers/Vherus)[@vherus](https://github.com/vherus)

---

Top Contributors

[![vherus](https://avatars.githubusercontent.com/u/5518649?v=4)](https://github.com/vherus "vherus (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/vherus-depot/health.svg)

```
[![Health](https://phpackages.com/badges/vherus-depot/health.svg)](https://phpackages.com/packages/vherus-depot)
```

###  Alternatives

[seld/cli-prompt

Allows you to prompt for user input on the command line, and optionally hide the characters they type

24726.4M22](/packages/seld-cli-prompt)[illuminate/console

The Illuminate Console package.

13045.3M6.2k](/packages/illuminate-console)[styleci/cli

The CLI tool for StyleCI

71464.1k9](/packages/styleci-cli)[winbox/args

Windows command-line formatter

20718.9k21](/packages/winbox-args)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)