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.

Doctrine DBAL integration

Database-backed foundation for Ecotone, built on Doctrine DBAL. Use your existing relational database as a message transport, outbox, dead letter store, or durable saga state — no extra infrastructure required to get started.

• DBAL message channel — durable asynchronous channel backed by your database
• Outbox pattern — atomic commit of business state and outbound messages, so no event is lost on crash (details)
• Dead Letter Queue — failed messages persisted to your database, inspectable and replayable
• Saga state storage — non-event-sourced sagas persist their state per #[Identifier] in your DB
• Document Store — aggregates persisted as JSON documents, no ORM required
• Business Interfaces — declarative DBAL query methods via #[DbalBusinessMethod]
• Transactional message handling — each handler wrapped in a DB transaction automatically

Works with Doctrine ORM, Eloquent, and raw PDO — pick the ORM your framework already uses.

Visit ecotone.tech to learn more.

Works with Symfony, Laravel, or 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, Doctrine DBAL, Ecotone, Outbox, Dead Letter Queue, Document Store, Message Channel, Transactional Messaging