Last updated at 26 March 2018 | Published at 14 March 2018



  • symfony/yaml now allows ^3.2|^4.0


Breaking Changes

  • The AggregateRootRepository is now an interface. The default implementation is the ConstructingAggregateRootRepository.
  • The Event interface is removed. A new SerializableEvent interface is provided to aid the default serializers. If you use the default serializers your events must implement this interface. The methods are the same as the Event interface, so effectively it’s an in-place replacement.
  • The CodeDumper is changed to ensure code now implements the SerializableEvent interface.
  • The AggregateRootTestCase now allows you to overwrite the aggregateRootRepository method for if/when you have a custom implementation and still want all the benefits of the default test tooling.



  • The Header::AGGREGATE_ROOT_ID is no longer converted to string in the default decorator but in the serializer.
  • The Header::AGGREGATE_ROOT_ID_TYPE is now set in the serializer.



  • The CodeDumper now generated prettier code.


BC Breaks

  • The PointInTime related properties of the Event interface are removed. The DefaultHeadersDecorator now ensures all events receive a Header::TIME_OF_RECORDING headers.
  • The AggregateRoot now keeps track of a version, the ConstructionBehaviour trait has been updated to reflect this and shows how it’s implemented.
  • The AggregateRootTestCase now requires you to implement the newAggregateRootId method to be able to return a stable aggregate root id from the aggregateRootId method.



  • The MessageDispatcherChain is introduced to be able to chain multiple dispatchers together. This allows users to compose a dispatching system that combined synchronous and a-synchronous message handling.



  • The BaseAggregateRoot behaviour is now extracted into traits so you can choice to implement certain concerns yourself without overriding methods.