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.

AWS SQS transport

Route #[Asynchronous] handlers to AWS SQS queues. Managed messaging for teams already on AWS, with automatic retry, outbox, and dead letter handling — all through the same Ecotone pipeline that works with RabbitMQ, Kafka, Redis, and DBAL, so switching transports never changes your handler or test code.

Standard and FIFO queues supported
IAM-based authentication via the AWS SDK
Dead letter redrive — integrates with SQS DLQ and Ecotone's error channels
Long polling — efficient consumer loop

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 / sqs

Maintainers

Package info

Fund package maintenance!

Statistics

Security