README

To contribute make use of Ecotone-Dev repository.

Ecotone is the PHP architecture layer that grows with your system — without rewrites.

From #[CommandHandler] on day one, to event sourcing, sagas, outbox, and distributed messaging at scale — one package, same codebase, no forced migrations between growth stages. Declarative PHP 8 attributes on the classes you already have.

Ecotone for Symfony

Symfony Messenger gives you a bus. Ecotone gives you the full architecture on top — Event Sourcing, Sagas and durable workflows, Outbox, and per-handler failure isolation, so one failing listener never blocks another.

• Symfony Messenger compatible — your existing transports keep working
• Bundle auto-configuration — zero config to start
• Doctrine ORM integration — aggregates and projections via DBAL
• Pure POPOs — no base classes, no interfaces to implement

composer require ecotone/symfony-bundle

See the Symfony integration guide for setup and configuration details.

Visit ecotone.tech to learn more.

Ecotone also works with Laravel and any PSR-11 framework via Ecotone Lite.

Getting started

See the quickstart guide and reference documentation. Read more on the Ecotone Blog.

AI-Ready documentation

Ecotone ships with MCP server, Agentic Skills, and LLMs.txt for any coding agent. See the AI Integration Guide.

Feature requests and issue reporting

Use issue tracking system for new feature request and bugs. Please verify that it's not already reported by someone else.

Contact

If you want to talk or ask questions about Ecotone

• Twitter
• support@simplycodedsoftware.com
• Community Channel

Support Ecotone

If you want to help building and improving Ecotone consider becoming a sponsor:

• Sponsor Ecotone
• Contribute to Ecotone.

Tags

PHP, Symfony, Symfony Bundle, DDD, CQRS, Event Sourcing, Sagas, Projections, Durable Workflows, Workflows, Outbox, Service Bus, Messenger