Upgrade to 1.0.0

Last updated at 30 March 2021 | Published at 06 April 2020

PHP 8.0

From EventSauce 1.0 a higher PHP version is required, namely 8.0 and above.

Upgrade automation

For those of you who want to speed up the migration from 0.8 to 1.0 there is a set of Rector instructions that automate a big part of the work.

Check out the Rector Set.


The Consumer class was renamed:

- use EventSauce\EventSourcing\Consumer;
+ use EventSauce\EventSourcing\MessageConsumer;

The Aggregate AggregateRootTestCase was put into its own package:

composer require --dev eventsauce/test-utilities
- use EventSauce\EventSourcing\AggregateRootTestCase;
+ use EventSauce\EventSourcing\TestUtilities\AggregateRootTestCase;

Clock is moved to a dedicated package

The clock package is included in EventSacue by default. The classes were moved into their own namespace EventSauce\Clock. This means the Clock, TestClock, and SystemClock have moved.

The currentTime method was renamed to now to prepare for the upcoming (PHP-FIG standard for Clocks)[https://github.com/php-fig/fig-standards/blob/master/proposed/clock.md].

If you wish to separately use the clock package, include it using composer:

composer require eventsauce/clock

Added return types

Some classes were missing return types for void returns.

  • From MessageConsumer (previously Consumer), the handle method now has a void return type.
  • From MessageRepository, the handle method now has a persist return type.
  • From MessageRepository, the handle method now has a persistEvents return type.

Extracted packages

The test utilities are shipped separately, install them using:

composer require --dev eventsauce/test-utilities

Code generation is shipped as a separate module, add them to your project using:

composer require --dev eventsauce/code-generation
Frank de Jonge

EventSauce is a project by Frank de Jonge.