Weave Code
Code Weaver
Helps Laravel developers discover, compare, and choose open-source packages. See popularity, security, maintainers, and scores at a glance to make better decisions.
Feedback
Share your thoughts, report bugs, or suggest improvements.
Subject
Message
Log in Register
Home
Packages
Laravel Event Sourcing
Changelog

Laravel Event Sourcing Laravel Package

spatie/laravel-event-sourcing

Event sourcing toolkit for Laravel: build aggregates, projectors, and reactors to store state changes as events. Ideal for audit trails, decisions based on history, and future reporting needs. Includes docs, examples, and an optional course.

View on GitHub
Deep Wiki
Context7
7.15.0

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.14.0...7.15.0

7.14.0

What's Changed

  • Add Laravel 13 and PHP 8.5 support
  • Fix Projection model boot compatibility with Laravel 13
7.13.0

What's Changed

  • Lazy-resolve event handlers to eliminate boot-time overhead (#523)

When registering projectors and reactors via class name strings, container resolution is now deferred until the handlers are actually needed. Most HTTP requests never fire a stored event, so the boot-time cost is never paid.

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.12.9...7.13.0

7.12.9

What's Changed

  • Fix #[Ignore] attributes on ShouldBeStored conflicting with child class properties

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.12.8...7.12.9

7.12.8

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.12.7...7.12.8

7.12.7

What's Changed

7.12.6

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.12.5...7.12.6

7.12.5

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.12.4...7.12.5

7.12.4

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.12.3...7.12.4

7.12.3

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.12.2...7.12.3

7.12.2

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.12.1...7.12.2

7.12.1

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.12.0...7.12.1

7.12.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.11.3...7.12.0

7.11.3

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.11.2...7.11.3

7.11.2

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.11.1...7.11.2

7.11.1

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.11.0...7.11.1

7.11.0

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.10.3...7.11.0

7.10.3

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.10.2...7.10.3

7.10.2

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.10.1...7.10.2

7.10.1

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.10.0...7.10.1

7.10.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.9.1...7.10.0

7.9.1

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.9.0...7.9.1

7.9.0

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.8.0...7.9.0

7.8.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.7.0...7.8.0

7.7.0

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.6.2...7.7.0

7.6.2

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.6.1...7.6.2

7.6.1

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.6.0...7.6.1

7.6.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.5.0...7.6.0

7.5.0

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.4.2...7.5.0

7.4.2
  • fix AllowDynamicProperties to suppress PHP warnings on 8.2

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.4.1...7.4.2

7.4.1

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.4.0...7.4.1

7.4.0

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.3.10...7.4.0

7.3.10

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.3.9...7.3.10

7.3.9

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.3.8...7.4.0

7.3.8

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.3.7...7.3.8

7.3.7

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.3.6...7.3.7

7.3.6

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.3.5...7.3.6

7.3.5

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.3.4...7.3.5

7.3.4

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.3.3...7.3.4

7.3.3

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.3.2...7.3.3

7.3.2

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.3.1...7.3.2

7.3.1

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.3.0...7.3.1

7.3.0

What's Changed

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.2.4...7.3.0

7.2.4

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.2.3...7.2.4

7.2.3

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.2.2...7.2.3

7.2.2

What's Changed

New Contributors

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/7.2.1...7.2.2

7.2.1
7.2.0
  • Add EloquentStoredEventQueryBuilder::lastEvent (#327)
  • Add EloquentStoredEventQueryBuilder::wherePropertyIs (#326)
  • Add EloquentStoredEventQueryBuilder::wherePropertyIsNot (#326)
7.0.1
  • Fix for meta data updating on original event (#324)
6.0.5
  • Change event_version to tinyint in migration stub (#306)
6.0.4
  • Don't mutate original events in FakeAggregateRoot::getRecordedEventsWithoutUuid (#296)
6.0.3
6.0.2
  • Skip retrieve on aggregate::fake (#294)
6.0.1
  • Fix for aggregate root testing without a database (#292)
5.0.8
5.0.7
5.0.6
  • fix AggregateRoot return types for static analysis (#251)
5.0.5
  • Use jsonb in migration stubs instead of json (#237)
5.0.4
  • Fix visual glitch in event-sourcing:list command where event handlers wouldn't be shown
5.0.3
  • fix $whenResult (#227)
5.0.2
  • Support legacy spatie/laravel-schemaless-attributes:^1.0 as well
5.0.1
  • move migrations to default location
5.0.0

  • Add EloquentStoredEvent::query()->whereEvent(EventA::class, …)

  • Add EventQuery

  • Add AggregatePartial

    • If you're overriding an aggregate root's constructor, make sure to call parent::__construct from it

  • Add command bus and aggregate root handlers

  • Add Projectionist::fake(OriginalReactor::class, FakeReactor::class) (#181)

  • All event listeners are now registered in the same way: by looking at an event's type hint. This applies to all:

    • Aggregate root apply methods
    • Projection listeners
    • Reactor listeners
    • Event queries

  • Moved Spatie\EventSourcing\Exception\CouldNotPersistAggregate to Spatie\EventSourcing\AggregateRoots\Exceptions\CouldNotPersistAggregate

  • Moved Spatie\EventSourcing\Exception\InvalidEloquentSnapshotModel to Spatie\EventSourcing\AggregateRoots\Exceptions\InvalidEloquentSnapshotModel

  • Moved Spatie\EventSourcing\Exception\InvalidEloquentStoredEventModel to Spatie\EventSourcing\AggregateRoots\Exceptions\InvalidEloquentStoredEventModel

  • Moved Spatie\EventSourcing\Exception\MissingAggregateUuid to Spatie\EventSourcing\AggregateRoots\Exceptions\MissingAggregateUuid

  • Moved Spatie\EventSourcing\Exception\InvalidStoredEvent to Spatie\EventSourcing\StoredEvents\Exceptions\InvalidStoredEvent

  • Dependency injection in handlers isn't supported anymore, use constructor injection instead

  • $storedEvent and $aggregateRootUuid are no longer passed to event handler methods. Use $event->storedEventId() and $event->aggregateRootUuid() instead. (#180)

  • Rename EloquentStoredEvent::query()->uuid() to EloquentStoredEvent::query()->whereAggregateRoot()

  • Removed AggregateRoot::$allowConcurrency

  • Removed $aggregateVersion from StoredEventRepository::persist

  • Removed $aggregateVersion from StoredEventRepository::persistMany

  • Event handlers are no longer called with app()->call() (#180)

  • $handlesEvents on Projectors and Reactors isn't supported anymore

  • PHP version requirement is now ^8.0

  • Laravel version requirement is now ^8.0

A note on changed listeners

Since most code is probably already type hinting events, the listener change is likely to not have an impact on your code. It's good to know though that you don't have to worry about certain naming conventions any more:

  • In aggregate roots, you don't have to prefix apply methods with apply anymore if you don't want to
  • In projectors, you don't need a manual mapping anymore, neither does the event variable need to be called $event
  • In reactors, you don't need a manual mapping anymore, neither does the event variable need to be called $event
  • Event queries are a new concept and work in the same way

Here's an example:

class MyProjector extends Projector
{
    public function anEventHandlerWithAnotherName(MyEvent $eventVariableWithAnotherName): void
    {
        // This handler will automatically handle `MyEvent`
    }
}

Note that __invoke in projectors and reactors works the same way, it's automatically registered based on the type hinted event.

4.10.2
  • Add missing config key in config stub (#203)
4.10.1
  • Also store aggregate root version when one event is persisted
4.10.0
  • Deprecate AggregateRoot::$allowConcurrency
  • Fix for race condition in aggregate roots (#170), you will need to run a migration to be able to use it:
public function up()
{
    Schema::table('stored_events', function (Blueprint $table) {
        $table->unique(['aggregate_uuid', 'aggregate_version']);
    });
}

Note: if you run this migration, all aggregate roots using $allowConcurrency will not work any more.

4.9.0
  • Make base path configurable (#202)
4.8.0
  • Add support for asserting events with a closure
4.7.2
  • Fix for broken dependency in 4.7.1
4.7.1
  • Fix for array serialization (#189)
4.7.0
  • add support for PHP 8
4.6.1
  • remove unused replay_chunk_size config value
4.6.0
  • allow protected apply methods (#136)
4.5.3
  • re-use existing instance of ShouldBeStored when possible (#158)
4.5.2
  • fix Paths and Reference URL in event-sourcing.php config file (#159)
4.5.1
  • added loadUuid (#156)
4.5.0
  • make normalizers configurable (#153)
4.4.0
  • Support then for aggregate root fakes (#154)
4.3.1
  • Support Laravel 8
4.3.0
  • support Carbon dates in events (#137)
4.2.0
  • allow events to be dispatched from an aggregate root (#135)
4.1.0
  • add assertion that specific event is recorded (#134)
4.0.2
  • config style fix
4.0.1
  • add snapshot_model config key
4.0.0
  • projectors now are abstract classes instead of interfaces
  • reactors can now be easily defined by extending the reactor base class
  • projectors and reactors can be marked as async by implementing the ShouldQueue marker interface
  • events that extend ShouldBeStored now can retrieve the aggregate root uuid using aggregateRootUuid()
  • the package has been restructured. Namespaces of most classes have been updated.
  • events that extend ShouldBeStored can now handle metadata using metaData and setMetaData
  • aggregate roots can now be persisted without calling event handlers using persistWithoutApplyingToEventHandlers
  • the projectionist can now handle manually specified events using handleStoredEvents
  • added persistAggregateRootsInTransaction to AggregateRoot
  • you can now get the uuid of an aggregate root using the uuid() method
  • the reset method has been removed on projectors
  • the fake method on an aggregate root now accepts a uuid instead of an array of events
  • the meta_data property on StoredEvent is now an array or a string instead of SchemalessAttributes
  • apply methods on aggregates can now make use of method injection
  • pass metadata to serializer to allow events to be upgraded (#112)
3.2.3
  • default to BigIncrements on package table stubs (#124)
3.2.2
  • replace model where clause with uuid model scope (#123)
3.2.1
  • config file comment corrections (#121)
3.2.0
  • expose aggregate_version of StoredEvent (#115)
3.1.8
  • use app helper (#117)

master

3.1.7
  • allow aggregate roots to have dependencies in constructor (#111)
3.1.6
  • wrong tag, nothing changed
3.1.5
  • only include public properties of the aggregate when snapshotting (#105)
3.1.4
  • simplify snapshot dates
3.1.3
  • add static return type docblock for AggregateRoot::retrieve
3.1.2
  • make sure created_at is filled when creating a snapshot
3.1.1
  • expose AggregateRoot for testing state (#75)
3.1.0
  • add support for Laravel 7
3.0.4
  • fix for serializing events that use immutable datetime objects (#67)
3.0.3
  • fixes for Lumen
3.0.2
  • only replace the first instance of the basePath in DiscoversEventHandlers (#62)
3.0.1
  • publish snapshots migration
3.0.0
  • add the ability to snapshot aggregates
  • make all classes non-final
  • do not allow concurrent persist on an aggregate by default
2.1.0
  • add countAllStartingFrom
2.0.1
  • do not dispatch job when there is nothing to be performed on queue
2.0.0
  • drop PHP 7.3
1.0.4
  • fix replay from specified event id (#33)
1.0.3
  • provide docblocks to AggregateRoot class (#31)
1.0.2
  • implemented missing HandleDomainEventJob interface
  • use a UUID field when possible for storing UUIDs
1.0.1
  • fix an issue with encoding the event_properties when they're already a string
1.0.0
  • initial release

This package supercedes spatie/laravel-event-projector

To learn how to upgrade from laravel-event-projector v3 to laravel-event-sourcing v1 , read our upgrade guide

What's
New

Full Changelog: https://github.com/spatie/laravel-event-sourcing/compare/5.0.6...5.0.7

6.0.0
  • Support PHP 8.1
  • The EventHandler interface was changed in order to use the spatie/better-types package:
-    public function handles(): array;
+    public function handles(StoredEvent $storedEvent): bool;

-    public function handle(StoredEvent $event);
+    public function handle(StoredEvent $storedEvent): void;
Weaver

How can I help you explore Laravel packages today?

Conversation history is not saved when not logged in.
Prompt
Add packages to context
No packages found.
davejamesmiller/laravel-breadcrumbs
artisanry/parsedown
christhompsontldr/phpsdk
enqueue/dsn
bunny/bunny
enqueue/test
enqueue/null
enqueue/amqp-tools
milesj/emojibase
bower-asset/punycode
bower-asset/inputmask
bower-asset/jquery
bower-asset/yii2-pjax
laravel/nova
spatie/laravel-mailcoach
spatie/laravel-superseeder
laravel/liferaft
nst/json-test-suite
danielmiessler/sec-lists
jackalope/jackalope-transport