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.

Apache Kafka transport

Route #[Asynchronous] handlers to Kafka topics with partition-aware consumers and the same retry, outbox, and dead letter semantics as every other Ecotone transport. Publish from one service and consume in another via the Distributed Bus — switching transports never changes how your handlers or tests are written. Carries asynchronous communication and durable workflow execution on the same broker.

• Partitioned consumers — ordering guarantees per key
• Consumer groups — scale out horizontally
• Distributed Bus compatible — cross-service events and commands
• librdkafka-based — production-proven client

Built on top of librdkafka via the PHP rdkafka extension.

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, Kafka, Apache Kafka, Ecotone, Message Broker, Distributed Messaging, Event Streaming, Event Driven Architecture