Skip to content

[Messenger] Add documentation for the disable_default_bind option#21940

Merged
javiereguiluz merged 1 commit intosymfony:8.1from
xammmue:patch-1
Mar 13, 2026
Merged

[Messenger] Add documentation for the disable_default_bind option#21940
javiereguiluz merged 1 commit intosymfony:8.1from
xammmue:patch-1

Conversation

@xammmue
Copy link

@xammmue xammmue commented Feb 10, 2026

@carsonbot carsonbot added this to the 8.1 milestone Feb 10, 2026
@carsonbot carsonbot changed the title Add documentation for the disable_default_bind option Add documentation for the disable_default_bind option Feb 10, 2026
@javiereguiluz javiereguiluz added the Waiting Code Merge Docs for features pending to be merged label Feb 10, 2026
@carsonbot carsonbot modified the milestones: 8.1, next Feb 10, 2026
nicolas-grekas added a commit to symfony/symfony that referenced this pull request Feb 11, 2026
…g via queues option (xammmue)

This PR was merged into the 8.1 branch.

Discussion
----------

[Messenger][AMQP] Allow disabling default queue binding via queues option

[Messenger] Add option disable_default_bind to prevent the creation of or binding to the default messages queue when not defining any queue for an exchange

| Q             | A
| ------------- | ---
| Branch?       | 8.1
| Bug fix?      | no
| New feature?  | yes
| Deprecations? | no
| Issues        | Fix #63345
| License       | MIT

When not configuring any queues for an exchange and executing the `messenger:setup` command, a default queue `messages` was created and bound to those exchanges.
This PR introduces the possibility to set the queues configuration parameter to `[]` or `false` to prevent the creation of the `messages` queue.

Example configuration (`SENDING_EXCHANGE` uses the new configuration option)
```
framework:
    messenger:
        transports:
            exchange_out_1:
                dsn: '%messenger_transport_dsn%'
                options:
                    exchange:
                        name: 'SENDING_EXCHANGE_1'
                        type: fanout
                    auto_setup: false
                    queues: false
            exchange_out_2:
                dsn: '%messenger_transport_dsn%'
                options:
                    exchange:
                        name: 'SENDING_EXCHANGE_1'
                        type: fanout
                    auto_setup: false
                    queues: []
            incoming_events:
                dsn: '%messenger_transport_dsn%'
                options:
                    exchange:
                        name: 'RECEIVING_EXCHANGE'
                        type: direct
                    queues:
                        incoming_events_queue: ~
                    auto_setup: true
```

TODO:
- [x] verify / adapt documentation => symfony/symfony-docs#21940

Commits
-------

006db46 [Messenger][AMQP] Allow disabling default queue binding via queues option
@javiereguiluz javiereguiluz removed the Waiting Code Merge Docs for features pending to be merged label Mar 13, 2026
@javiereguiluz javiereguiluz modified the milestones: next, 8.1 Mar 13, 2026
@carsonbot carsonbot changed the title Add documentation for the disable_default_bind option [HttpKernel] Add documentation for the disable_default_bind option Mar 13, 2026
@carsonbot carsonbot changed the title [HttpKernel] Add documentation for the disable_default_bind option Add documentation for the disable_default_bind option Mar 13, 2026
@carsonbot carsonbot changed the title Add documentation for the disable_default_bind option [Messenger] Add documentation for the disable_default_bind option Mar 13, 2026
@javiereguiluz javiereguiluz merged commit 50199c2 into symfony:8.1 Mar 13, 2026
2 of 3 checks passed
@javiereguiluz
Copy link
Member

Merged! Thanks Max.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants