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.

OpenTelemetry integration

Distributed tracing for every message in your Ecotone application. Commands, events, queries, async handlers, saga steps, and projections are traced automatically — so the full causal chain across sync and async flows is visible in any OTLP-compatible backend (Jaeger, Tempo, Grafana, Honeycomb, Datadog, New Relic, and others).

Automatic span creation per handler invocation
Trace context propagation across async channels — traces don't break when a message crosses a queue
W3C Trace Context and B3 headers supported
Metrics and logs can be attached alongside traces via the OpenTelemetry SDK

No manual instrumentation required — enabling the module traces every handler Ecotone already knows about.

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

Support Ecotone

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

ecotone / open-telemetry

Maintainers

Package info

Fund package maintenance!

Statistics

Security