Introduction | laravel-event-sourcing | Spatie SPATIE Laravel Event Sourcing ========================= spatie.be/open-source [Docs](https://spatie.be/docs) [Laravel-event-sourcing](https://spatie.be/docs/laravel-event-sourcing/v6) Introduction Version v7 v6 v5 v4 v3 v2 v1 Other versions for crawler [v7](https://spatie.be/docs/laravel-event-sourcing/v7) [v6](https://spatie.be/docs/laravel-event-sourcing/v6) [v5](https://spatie.be/docs/laravel-event-sourcing/v5) [v4](https://spatie.be/docs/laravel-event-sourcing/v4) [v3](https://spatie.be/docs/laravel-event-sourcing/v3) [v2](https://spatie.be/docs/laravel-event-sourcing/v2) [v1](https://spatie.be/docs/laravel-event-sourcing/v1) - [ Introduction ](https://spatie.be/docs/laravel-event-sourcing/v6/introduction) - [ Support us ](https://spatie.be/docs/laravel-event-sourcing/v6/support-us) - [ Requirements ](https://spatie.be/docs/laravel-event-sourcing/v6/requirements) - [ Installation & setup ](https://spatie.be/docs/laravel-event-sourcing/v6/installation-setup) - [ Questions and issues ](https://spatie.be/docs/laravel-event-sourcing/v6/questions-issues) - [ Changelog ](https://spatie.be/docs/laravel-event-sourcing/v6/changelog) - [ Upgrading ](https://spatie.be/docs/laravel-event-sourcing/v6/upgrading) - [ Resources and alternatives ](https://spatie.be/docs/laravel-event-sourcing/v6/resources-and-alternatives) - [ About us ](https://spatie.be/docs/laravel-event-sourcing/v6/about-us) Getting familiar with event sourcing ------------------------------------ - [ Introduction ](https://spatie.be/docs/laravel-event-sourcing/v6/getting-familiar-with-event-sourcing/introduction) - [ The traditional application ](https://spatie.be/docs/laravel-event-sourcing/v6/getting-familiar-with-event-sourcing/the-traditional-application) - [ Using projectors to transform events ](https://spatie.be/docs/laravel-event-sourcing/v6/getting-familiar-with-event-sourcing/using-projectors-to-transform-events) - [ Using aggregates to make decisions based on the past ](https://spatie.be/docs/laravel-event-sourcing/v6/getting-familiar-with-event-sourcing/using-aggregates-to-make-decisions-based-on-the-past) Using projectors ---------------- - [ Writing your first projector ](https://spatie.be/docs/laravel-event-sourcing/v6/using-projectors/writing-your-first-projector) - [ Creating and registering projectors ](https://spatie.be/docs/laravel-event-sourcing/v6/using-projectors/creating-and-configuring-projectors) - [ Making sure events get handled in the right order ](https://spatie.be/docs/laravel-event-sourcing/v6/using-projectors/making-sure-events-get-handled-in-the-right-order) - [ Thinking in events ](https://spatie.be/docs/laravel-event-sourcing/v6/using-projectors/thinking-in-events) Using reactors -------------- - [ Writing your first reactor ](https://spatie.be/docs/laravel-event-sourcing/v6/using-reactors/writing-your-first-reactor) - [ Creating and configuring reactors ](https://spatie.be/docs/laravel-event-sourcing/v6/using-reactors/creating-and-configuring-reactors) Using aggregates ---------------- - [ Writing your first aggregate ](https://spatie.be/docs/laravel-event-sourcing/v6/using-aggregates/writing-your-first-aggregate) - [ Creating and configuring aggregates ](https://spatie.be/docs/laravel-event-sourcing/v6/using-aggregates/creating-and-configuring-aggregates) - [ Testing aggregates ](https://spatie.be/docs/laravel-event-sourcing/v6/using-aggregates/testing-aggregates) - [ Snapshots ](https://spatie.be/docs/laravel-event-sourcing/v6/using-aggregates/snapshots) Advanced usage -------------- - [ Preparing events ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/preparing-events) - [ Replaying events ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/replaying-events) - [ Storing metadata ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/storing-metadata) - [ Handling exceptions ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/handling-exceptions) - [ Discovering projectors and reactors ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/discovering-projectors-and-reactors) - [ Using your own event storage model ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/using-your-own-event-storage-model) - [ Using your own event storage repository ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/using-your-own-event-storage-repository) - [ Using your own event serializer ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/using-your-own-event-serializer) - [ Using aliases for stored event classes ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/using-aliases-for-stored-event-classes) - [ Adding and Removing Projectors and Reactors ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/adding-and-removing-projectors-and-reactors) - [ Aggregate Partials ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/aggregate-partials) - [ Event Queries ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/event-queries) - [ Commands ](https://spatie.be/docs/laravel-event-sourcing/v6/advanced-usage/commands) You are viewing the documentation for **an older version** of this package. You can check the version you are using with the following command: ` composer show spatie/laravel-event-sourcing ` Laravel Event Sourcing ======================== Event sourcing for Artisans 📽 [ Repository ](https://github.com/spatie/laravel-event-sourcing) 3,751,066 900 Introduction ------------ ### On this page 1. [ A premium course on event sourcing ](#content-a-premium-course-on-event-sourcing) 2. [ We have badges! ](#content-we-have-badges) This package aims to be the entry point to get started with event sourcing in Laravel. It can help you setting up aggregates, projectors and reactors. If you've never worked with event sourcing, or are uncertain about what projectors, reactors and aggregates are, head over to [the getting familiar with event sourcing section](/laravel-event-sourcing/v5/getting-familiar-with-event-sourcing/introduction). Event sourcing might be a good choice for your project if: - your app needs to make decisions based on the past - your app has auditing requirements: the reason why your app is in a certain state is equally as important as the state itself - you foresee that there will be a reporting need in the future, but you don't know yet which data you need to collect for those reports Some concepts in the package, for example the testing methods of aggregates, were inspired by [Frank De Jonge](https://twitter.com/frankdejonge/)'s [EventSauce](https://eventsauce.io/) package. A premium course on event sourcing -------------------------------------------------------------------------------------------------------------------------------------------------------------- [Our premium course on event sourcing](https://event-sourcing-laravel.com) will greatly help you understand event sourcing concepts. In this course, we'll walk you through all the basics, and work our way towards the most complex topics. Though the knowledge presented is framework agnostic, the examples embrace Laravel. The course includes: - a beautifully designed e-book of > 200 pages - 2 hours of video content - an event sourced cart Laravel demo app We have badges! --------------------------------------------------------------------------------------------------- [![Latest Version](https://img.shields.io/github/release/spatie/laravel-event-sourcing.svg?style=flat-square)](https://github.com/spatie/laravel-event-sourcing/releases) [![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](https://github.com/spatie/laravel-event-sourcing/blob/main/LICENSE.md) [![Total Downloads](https://img.shields.io/packagist/dt/spatie/laravel-event-sourcing.svg?style=flat-square)](https://packagist.org/packages/spatie/laravel-event-sourcing)