Cqrs Bundle Laravel Package

Bus Dispatch

Explicit mode (SYNC/ASYNC/OUTBOX) bypasses the decider entirely. Use DEFAULT unless you have a specific reason to override.

cursor

Di Registrar Pattern

Every registrar has a register(ContainerBuilder $container, …): void method and is stateless — instantiated in CqrsExtension::load(), called once, discarded. Most take the section's configuration (register($container, array $config): dispatch modes, naming, retry policies, serialization,...

cursor

Handler Contract

There are no base classes (the abstract handlers were removed in 0.5: PHP cannot narrow their handle(Command $command) parameter).

cursor

Message Design

Messages (commands, queries, events) are immutable DTOs — data carriers with no behavior. Every message class should be:

cursor

Resolver Pattern

AbstractMessageTypeResolver + MessageTypeLocator implement hierarchy-aware service resolution. The resolution order is deterministic and intentionally more precise than Symfony's flat lookup:

cursor

Stamp Decider Pipeline

StampsDecider aggregates StampDecider implementations into a per-message-class pipeline. When AbstractMessengerBus::dispatchMessage() calls decide(), the aggregator runs all applicable deciders in priority order, threading the stamp array through each stage. The pipeline is cached per message...

cursor

Test Conventions

Unit tests (extend TestCase) — for testing a single class in isolation with mocked dependencies. Used for buses, resolvers, deciders, stamps, DI extension, compiler passes. No kernel boot overhead.

cursor