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 Lite — framework-agnostic

Not on Laravel or Symfony? Ecotone Lite integrates with your existing PSR-11 container to provide Command, Event, and Query buses — plus the full feature set of Aggregates, Sagas and durable workflows, Projections, and Event Sourcing. Same attributes, same testing, same architecture.

• Any PSR-11 container
• Full feature set available — nothing framework-specific is held back
• No framework lock-in
• Standalone or embedded — use as your application's entry point or alongside an existing HTTP layer

See the Ecotone Lite installation guide for setup details.

Visit ecotone.tech to learn more.

Ecotone also provides dedicated integrations for Symfony and Laravel.

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, PSR-11, Ecotone Lite, DDD, CQRS, Event Sourcing, Sagas, Projections, Durable Workflows, Workflows, Outbox, Service Bus