Download the PHP package proophsoftware/prooph-bundle without Composer

Symfony bundle for prooph components

Deprecated

Based on user feedback we've decided to start working on Symfony integration again. This bundle makes use of the interop-container aware factories shipped with each prooph component. However, using these factories in a Symfony environment works different than you know it from other bundles. If you are looking for real Symfony bundles check out:

• https://github.com/prooph/event-store-symfony-bundle
• https://github.com/prooph/service-bus-symfony-bundle

Overview

This is a Symfony bundle for prooph components to get started out of the box with message bus, CQRS, event sourcing and snapshots with the Symfony Doctrine Bundle. It uses Doctrine DBAL. There are more adapters available.

It provides all service definitions and a default configuration. This is more like a Quick-Start bundle. If you want to use the prooph components in production, we recommend to use only prooph-interop-bundle and configure the prooph components for your requirements. See the documentation for more details of the prooph components.

For rapid prototyping we recommend to use our prooph-cli tool.

Available services

• prooph.service_bus.command_bus: Dispatches commands
• prooph.service_bus.event_bus: Dispatches events
• prooph.event_bus.transaction_manager: Transaction manager for service bus and event store
• prooph.event_bus.event_publisher: Publishes events on the event bus
• prooph.event_store.doctrine_adapter: Doctrine adapter for event store
• prooph.event_store.snapshot_store: Event store snapshot adapter
• prooph.event_store.doctrine_snapshot_adapter: Doctrine snapshot adapter

Installation

You can install proophsoftware/prooph-bundle via composer by adding "proophsoftware/prooph-bundle": "^0.1" as requirement to your composer.json.

Finally, be sure to enable the following bundles in AppKernel.php by including the following:

Database

Setup your Doctrine database migrations for the Event Store and Snapshot. This bundle uses the Doctrine Migrations Bundle.

Update the generated migration class with prooph Doctrine event store schema helper:

And now for the snapshot table.

Update the generated migration class with prooph Doctrine snapshot schema helper:

Now it's time to execute the migrations:

Example

You have only to define your models (Entities, Repositories) and commands/routes. You find all these things in the prooph components documentation. Here is an example YAML config from the proophessor-do example app.

You have to use a single quote ' in the YAML configuration

Define the aggregate repository, command route and event route for RegisterUser in app/config/config.yml.

Add the service container factories. Here is an example of the corresponding service XML configuration with container-interop for the example above.

Here is an example how to call the RegisterUser command:

Here is an example how to get a list of all users from the example above:

Support

• Ask questions on prooph-users mailing list.
• File issues at https://github.com/proophsoftware/prooph-bundle/issues.
• Say hello in the prooph gitter chat.

Contribute

Please feel free to fork and extend existing or add new plugins and send a pull request with your changes! To establish a consistent code quality, please provide unit tests for all your changes and may adapt the documentation.

License

Released under the New BSD License.