What is Ecotone Framework?

Ecotone is the PHP framework for durable workflows, event sourcing, Domain-Driven Design, reliable messaging, and asynchronous communication — one Composer package that adds sagas, orchestrators, aggregates, projections, outbox, retries, and CQRS to Laravel, Symfony, or Tempest through declarative PHP attributes. It runs on the database and broker you already operate; no separate workflow service, no replay-deterministic DSL, no engine-specific event log.

Do I need Temporal or a separate workflow engine to build durable workflows in PHP?

No. Ecotone delivers durable execution on the database and broker you already run. Sagas persist state per identifier, chained workflows survive crashes through the outbox plus async channel, saga timeouts use a #[Delayed] attribute, and Orchestrators (Enterprise) give declarative multi-step workflows. There is no separate cluster to operate, no RoadRunner or ext-grpc requirement, no replay-deterministic DSL — workflows are plain PHP classes with attributes. If you have already adopted Temporal, Ecotone still fits around it for CQRS, projections, distributed messaging, multi-tenant routing, and sagas that aren't full workflows.

Which message brokers does Ecotone work with?

RabbitMQ, Apache Kafka, Amazon SQS, Redis, and the database (DBAL outbox) are first-party — and Ecotone also integrates with Enqueue transports, Symfony Messenger transports, and Laravel Queue channels. Handler code is broker-agnostic: a single #[Asynchronous('channel')] attribute works the same across every transport. CombinedMessageChannel writes the message to the database for the outbox guarantee and dispatches execution on the broker, so outbox draining stays on the database and consumers scale horizontally on RabbitMQ / SQS / Kafka.

Can I use Ecotone with Laravel, Symfony, or Tempest?

Yes. Ecotone ships dedicated packages for Laravel, Symfony, and Tempest that make integration seamless. After installation, Command, Event, and Query buses are available out of the box in the dependency container — and for any other framework, Ecotone Lite provides a standalone integration via PSR-11.

Do I need to rewrite my application to use Ecotone?

No. Ecotone works alongside your existing application — you adopt it incrementally for the parts where messaging, sagas, event sourcing, or distributed messaging make sense, without rewriting what already works. Ecotone sits above Symfony Messenger and Laravel Queues, using them as transports underneath rather than replacing them.

Why pick Ecotone for Event Sourcing?

Ecotone provides a built-in event store on PostgreSQL or MySQL with #[EventSourcingAggregate], #[ProjectionV2] for read models (global, partitioned, or streaming), non-blocking gap detection that catches concurrent-transaction events without blocking concurrent writes, projections that can publish their own events so dependents react in the same flow instead of a separate eventually-consistent process (with rebuild auto-suppression), and end-to-end PII encryption across the event store, broker payloads, and structured logs. As event volume grows, projections scale from a single cursor to N parallel workers via partitioning — without changing your domain code.

Does Ecotone support building systems following Domain-Driven Design?

Ecotone's vocabulary is DDD vocabulary: #[Aggregate], Repository abstraction, #[Saga] as process managers, bounded-context isolation via the Distributed Bus, and Domain Events as first-class plain PHP classes. Where each building block is fully decoupled from the framework using declarative configuration. Ecotone is the only framework that makes DDD build blocks easily composable in Message-Driven systems, to not only ensure clear business logic, but to make the system build on top of reliable architecture.

The PHP Orchestration Layer

Orchestrators with routing-slip semantics, Sagas as stateful coordinators, Distributed Bus + Service Map between PHP services, EIP primitives as attributes, multi-tenant header-routed channels — one declarative orchestration model.

Orchestration Layer — full guide Install Ecotone

Composer package · Laravel, Symfony, or Tempest · PostgreSQL or MySQL · RabbitMQ, Kafka, SQS, Redis, or DBAL outbox

What Ecotone provides

Capabilities relevant to orchestration layer

Sagas & Workflows

Stateful long-running processes with compensation. Handler-chaining workflows for stateless pipelines. Saga timeouts in one #[Delayed] attribute. All declarative, all attribute-driven.

Durable Workflows in Plain PHP

Crash-resistant multi-step processes on your existing database and broker. Sagas, orchestrators, chained workflows, outbox, and #[Delayed] timeouts — plain PHP attributes, no separate workflow service, no replay-deterministic DSL.

Compose Patterns Without Glue

Aggregate publishes event. Saga subscribes by attribute. Projection subscribes by attribute. Async handler subscribes by attribute. The attribute is the wiring.

Composable EIP Messaging

Pipe handlers together. Route by payload or headers. Split one message into many. Filter, enrich, transform — all as attributes, no glue code.

Multi-tenant Messaging

Tenant-isolated event streams, tenant-routed message channels, priority routing by customer status. Multi-tenancy as a topology property, not a WHERE clause.

Endpoint-ID Routing

Rename classes, move handlers, refactor namespaces — messages still route correctly. The endpoint ID is the contract; FQCN is not on the wire.

How it compares

What Ecotone adds over a single-purpose tool

Each tool below is a capable choice for its slice. Ecotone covers the same ground and adds the operational layer around it — so aggregates, projections, sagas, and messaging share one model and one set of guarantees.

Temporal PHP SDK

Durable orchestration on a dedicated runtime.

Where Ecotone goes further than this library

Ecotone's orchestration runs inside your PHP application process — no separate worker runtime, RoadRunner, or gRPC.
Your existing RabbitMQ / Kafka / SQS carry cross-service messages directly, rather than through the engine's internal task queues.
First-class EIP primitives — routers, splitters, filters, enrichers — compose with Orchestrators and Sagas as attributes on plain methods.

Durable Workflow (formerly Laravel Workflow)

A focused Laravel-native workflow engine.

Where Ecotone goes further than this library

Ecotone adds a first-class EIP layer — routers, splitters, filters, enrichers — as attributes alongside Orchestrators and Sagas.
A Distributed Bus and Service Map declare a cross-service, multi-broker topology in one place.
Header-routed multi-tenant channels run in one deployment.
Runs on Laravel or Symfony, across any broker.

Symfony Messenger alone

A solid transport-level message bus.

Where Ecotone goes further than this library

Ecotone adds first-class EIP primitives — routers, splitters, filters, enrichers — as attributes on plain methods.
A Distributed Bus and Service Map declare a cross-service, multi-broker topology in one place.
Header-routed multi-tenant channels run in one deployment.
Built on Messenger transports, so existing transport config carries over.

Ecotone

Process orchestration, service orchestration, and message routing on one model.

Process orchestration: #[Orchestrator], #[Saga], chained #[InternalHandler] workflows.
Service-to-service orchestration: Distributed Bus + Service Map across multiple brokers.
Message-routing orchestration: routers, splitters, filters, enrichers, transformers as EIP primitives on plain methods.
CQRS message buses (CommandBus, EventBus, QueryBus) out of the box on Laravel, Symfony, Tempest, or Ecotone Lite.
Multi-tenant header-routed channels in one deployment.
No Java cluster to operate, no BPMN modeller required.
Shared retry / DLQ / idempotency / PII / OpenTelemetry middleware across the orchestrator and the handlers it dispatches into — not three separate retry stories you reconcile by hand.

Read the Orchestration Layer guide

Frequently asked questions

Haven’t found what you’re looking for? Contact us

Ecotone. It provides the same architectural tier — declaring how messages flow, which steps compose into processes, and where messages cross service boundaries — built on the same Enterprise Integration Patterns vocabulary that underpins Spring Integration, NServiceBus, MassTransit, and Wolverine. Routers, splitters, filters, enrichers, transformers are PHP attributes on plain methods; Orchestrators define multi-step workflows declaratively; Distributed Bus + Service Map route between PHP services over the brokers you already operate.

Camunda and Zeebe are mature BPMN engines and the right choice at the engine level if your organisation already operates a JVM cluster and stakeholders want BPMN diagrams. For PHP teams that don't want to add a Java cluster and don't have a BPMN-modelling requirement, Ecotone delivers declarative orchestration as PHP attributes inside your application — Orchestrators, Sagas, Distributed Bus, EIP primitives, multi-tenant routing — on the database and broker you already operate.

Each PHP service registers #[Distributed] handlers; the Distributed Bus routes commands and events between services over the broker you've configured (RabbitMQ, Kafka, SQS, Redis). The Service Map carries the topology — which service consumes which routing keys, on which broker — so adding a service is a config change, not a code change in every caller. Multi-broker single-topology: some services on Kafka, others on RabbitMQ, all coordinated through one Service Map.

An #[Orchestrator] defines a workflow as a sequence of channel names using the routing-slip pattern — each step is a #[InternalHandler] independently testable and reusable, and the orchestrator method returns the channel list for the next steps (including dynamic step lists chosen from input data). A #[Saga] is a stateful coordinator that remembers where it is across events arriving over time. Orchestrators are for processes where you know the steps up front; Sagas are for processes that react to external events asynchronously.

Be part of the change with Ecotone

Unleash the power of Messaging in PHP
and push productivity to the higher level

Get started