ecotone/amqp

AMQP / RabbitMQ transport for Ecotone asynchronous messaging, outbox, and dead letter.

1.309.3 2026-04-23 17:38 UTC

Requires

• ext-amqp: *
• ecotone/enqueue: ~1.309.3
• enqueue/amqp-ext: ^0.10.18
• enqueue/dsn: ^0.10.4
• enqueue/enqueue: ^0.10.0

Requires (Dev)

• ext-amqp: *
• doctrine/annotations: ^1.13|^2.0
• enqueue/amqp-ext: ^0.10.18
• enqueue/amqp-lib: ^0.10.25
• phpstan/phpstan: ^1.8
• phpunit/phpunit: ^10.5|^11.0
• wikimedia/composer-merge-plugin: ^2.1

Suggests

• ext-amqp: Required for using AMQP extension (default, recommended for production). Install together with enqueue/amqp-ext.
• enqueue/amqp-ext: Required for using AMQP extension (default, recommended for production). Requires ext-amqp.
• enqueue/amqp-lib: Required for using AMQP lib (pure PHP implementation). Required for AmqpStreamChannelBuilder and RabbitMQ Streams support.

Conflicts

• enqueue/amqp-ext: <0.10.18
• enqueue/amqp-lib: <0.10.25

Apache-2.0, proprietary

• Dariusz Gafka

• rabbitmq
• message
• AMQP
• messaging
• asynchronous
• rabbit
• Domain Driven Design
• enterprise integration patterns
• eip
• distributed architecture

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.

AMQP / RabbitMQ transport

Route #[Asynchronous] handlers to RabbitMQ. Exchanges, queues, and bindings are declared from your PHP configuration, and every message flows through Ecotone's standard retry, outbox, and dead letter pipeline — so switching to AMQP in production never changes how your handlers or tests are written.

Supports both implementations:

• AMQP Extension (enqueue/amqp-ext + ext-amqp) — default, recommended for production
• AMQP Lib (enqueue/amqp-lib) — pure PHP, required for RabbitMQ Streams

See AMQP_IMPLEMENTATION_SUPPORT.md for detailed information about using both implementations.

Visit ecotone.tech to learn more.

Works with Symfony, Laravel, or any PSR-11 framework via Ecotone Lite.

Testing

The package automatically tests both implementations:

cd packages/Amqp
composer tests:ci

See TESTING_BOTH_IMPLEMENTATIONS.md for more details.

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
• [e-mail]
• Community Channel

Support Ecotone

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

• Sponsor Ecotone
• Contribute to Ecotone.

Tags

PHP, AMQP, RabbitMQ, Ecotone, Message Broker, Asynchronous Messaging, Event Driven Architecture