Download the PHP package alesima/laravel-azure-service-bus without Composer

Laravel Azure Service Bus Queue Driver 🚀

Integrate Azure Service Bus as a queue driver and Pub/Sub module in Laravel, now with support for multiple topics.

This package provides a custom queue driver for Laravel that integrates with Azure Service Bus and adds support for Topics and Subscriptions (Pub/Sub), enabling both queue-based and publish/subscribe messaging models with the ability to manage multiple topics dynamically.

Features 🎯

• Azure Service Bus Integration: Seamlessly integrate Azure's messaging capabilities into your Laravel application.
• Support for Laravel 5.x - 8.x: Compatible with older Laravel versions and PHP 7.2 and above.
• Queue Operations: Push, pop, and manage jobs in Azure Service Bus queues with ease.
• Pub/Sub Module: Publish messages to multiple topics and subscribe to them using Azure Service Bus topics and subscriptions.
• Job Scheduling: Supports delayed jobs using later() with multiple formats (e.g., DateTime, DateInterval, int).
• Built with Laravel's Queuing System: Follows the same conventions, making it easy to work with.

Installation ⚙️

1. Install the package via Composer:

2. Publish the configuration:

After installing, publish the configuration file to adjust your Azure Service Bus settings.

3. Configure .env file:

In your .env file, set the Azure Service Bus connection details:

4. Define Azure Service Bus Configuration

Update your config/queue.php file to include the following configuration for the Azure Service Bus driver:

5. Register the service provider and the queue manager (optional):

If you are using Lumen, you need to register the service provider in bootstrap/app.php:

Also you might to register the queue manager in config/app.php:

Local Development & Testing with Docker 🐳

For local development and testing, you can use the official PHP 7.4 Docker image to ensure compatibility.

Run the following command to install dependencies using Docker:

How to test:

Usage 🛠️

Queue Operations

Push Jobs onto the Queue ⬆️

You can push jobs to Azure Service Bus using the standard Laravel syntax:

Use later() for Delayed Jobs ⏳

You can schedule jobs to be pushed after a delay using various formats:

Handle Jobs 🚀

When a job is received from the queue, it will be processed as a standard Laravel job:

Pub/Sub Module

The Pub/Sub module enables publishing messages to Azure Service Bus topics and receiving them from subscriptions. This now supports managing multiple topics dynamically.

Publish Messages to a Topic 📢

You can publish a message to a specific topic:

Subscribe to a Specific Topic 🔔

To retrieve messages from a subscription under a specific topic:

Retrieve Messages from Multiple Topics 🔄

To work with multiple topics dynamically:

Compatibility 🧩

This package is compatible with:

• Laravel: 5.x, 6.x, 7.x, and 8.x.
• PHP: 7.2 to 7.4.

Testing ⚡️

You can run tests using PHPUnit:

License 📜

This package is licensed under the MIT License. See LICENSE for more information.

Contributing 🤝

We welcome contributions to make this package even better!

1. Fork the repository.
2. Create a new branch.
3. Make your changes and commit them.
4. Open a pull request.

Credits 🏆

• Azure SDK for PHP: Provides the integration with Azure Service Bus.
• Laravel: The PHP framework that powers this package.

Attribution

Inspired by https://github.com/goavega-software/laravel-azure-servicebus-topic & https://github.com/pawprintdigital/laravel-queue-raw-sqs

Contact 📬

For any questions, feel free to reach out to us via GitHub Issues or email us at [email protected].