queue-interop / queue-interop
Promoting the interoperability of MQs objects. Based on Java JMS
Installs: 24 749 003
Dependents: 90
Suggesters: 1
Security: 0
Stars: 471
Watchers: 14
Forks: 20
Open Issues: 9
Requires
- php: ^7.1.3
Requires (Dev)
- phpunit/phpunit: ^5.5
- queue-interop/queue-spec: ^0.6@dev
This package is auto-updated.
Last update: 2024-11-21 22:12:52 UTC
README
About
queue-interop tries to identify and standardize a common way for PHP programs to create, send, receive and read MQ messages to achieve interoperability.
Through discussions and trials, we try to create a standard, made of common interfaces but also recommendations.
If PHP projects that provide queue implementations begin to adopt these common standards, then PHP applications and projects that use MQs can depend on the common interfaces instead of specific implementations. This facilitates a high-level of interoperability and flexibility that allows users to consume any MQ transport implementation that can be adapted to these interfaces.
The work done in this project is not officially endorsed by the PHP-FIG. We adhere to the spirit and ideals of PHP-FIG.
Installation
You can install this package through Composer:
# Install a Queue Interop compatible transport, for example
$ composer require enqueue/fs
Examples
Send a message:
<?php use Enqueue\Fs\FsConnectionFactory; $context = (new FsConnectionFactory())->createContext(); $context->createProducer()->send( $context->createQueue('aQueue'), $context->createMessage('aBody') );
Consume a message:
<?php use Enqueue\Fs\FsConnectionFactory; $context = (new FsConnectionFactory())->createContext(); $consumer = $context->createConsumer($context->createQueue('aQueue')); $timeout = 5000; // 5sec if ($message = $consumer->receive($timeout)) { // process the message. $consumer->acknowledge($message); }
Find out more here:
- Enqueue transport docs contains a lot how to use example.
- Formapro's Blog contains variety blog post about Queue Interop usage.
- RabbitMQ's official tutorials ported to AMQP Interop.
Compatible projects
Projects
- Enqueue
- Swarrot
- Bernard
- vladimir-yuldashev/laravel-queue-rabbitmq
- sonata-project/notification-bundle
- yiisoft/yii2-queue
- queue-interop/ext - Queue Interop as PHP extension. Useful for Phalcon developers.
Implementations
- enqueue/amqp-ext
- enqueue/amqp-lib
- enqueue/amqp-bunny
- makasim/rabbitmq-cli-consumer-client
- enqueue/pheanstalk
- enqueue/stomp
- Amazon SQS enqueue/sqs
- Amazon SNS enqueue/sns
- Amazon SNS\SQS enqueue/sns
- Google PubSub enqueue/gps
- enqueue/rdkafka
- enqueue/redis
- enqueue/mongodb
- enqueue/gearman
- enqueue/dbal
- enqueue/fs
- enqueue/null
- enqueue/wamp
- makasim/php-fpm-queue
- assoconnect/enqueue-azure
Amqp interop
There is AMQP interop built on top of Queue Interop. It is completly compatible with queue interop and only adds some AMQP specific features:
- Queue\Exchange declaration
- Queue\Exchange Binding.
- Basic consume support.
- and other AMQP specific features.
Compatible projects
Workflow
Everyone is welcome to join and contribute.
We try to not break BC by creating new interfaces instead of editing existing ones.
While we currently work on interfaces, we are open to anything that might help towards interoperability, may that be code, best practices, etc.