README

Make sure Composer is installed globally, as explained in the installation chapter of the Composer documentation.

Applications that use Symfony Flex

Open a command console, enter your project directory and execute:

$ composer require microsoftazure/azure-service-bus-messenger

Applications that don't use Symfony Flex

Step 1: Download the Bundle

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

$ composer require microsoftazure/azure-service-bus-messenger

Step 2: Enable the Bundle

Then, enable the bundle by adding it to the list of registered bundles in the config/bundles.php file of your project:

// config/bundles.php

return [
    // ...
    MicroSoftAzure\AzureServiceBusMessenger\AzureServiceBusMessenger::class => ['all' => true],
];

Configuration

The Azure Service Bus DSN looks like this, where sb-endoint is usually <namesapce>.servicebus.windows.net

# .env
MESSENGER_TRANSPORT_DSN=azure-service-bus://<sb-endpoint>

The transport has a number of options:

You can change the entity_path at runtime using the AzureServiceBusEntityPathStamp:

$eventBus->dispatch($someMessage, [new AzureServiceBusEntityPathStamp('someEntityPath')]);

You can control the entity_path used on consume with:

php bin/console messenger:consume my_transport --queues=someEntityPath