Cover of the book Symfony 5: The Fast Track

Symfony 5: The Fast Track is the best book to learn modern Symfony development, from zero to production. +300 pages showcasing Symfony with Docker, APIs, queues & async tasks, Webpack, SPAs, etc.

  1. Home
  2. Blog
  3. New in Symfony 4.3: Messenger failure transport

New in Symfony 4.3: Messenger failure transport

May 3, 2019 Avatar of Javier Eguiluz Javier Eguiluz

Warning: This post is about an unsupported Symfony version. Some of this information may be out of date. Read the most recent Symfony Docs.

Contributed by
Ryan Weaver
in #30970.

The Messenger component provides a retry mechanism for messages. In Symfony 4.3 we've improved this feature to add a "failure" transport, so that messages that fail on all their retries can be collected in one spot and retried later if wanted.

Consider the following configuration:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
framework:
    messenger:
        failure_transport: failed

        transports:
            async:
                dsn: 'amqp://'
            failed:
                dsn: 'doctrine://default?queue_name=failed'

        routing:
            'App\Message\SmsNotification': async

In this setup, SmsNotification would be retried three times on the async transport and then finally sent to the failed transport. You can consume the failed transport like a normal transport, but you should handle and consume it by one of these new commands:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
$ php bin/console messenger:failed:show

  There are 3 messages waiting in the failed transport.

  ---  ---------------------------  -------------------  -----
  Id   Class                        Failed at            Error
  ---  ---------------------------  -------------------  -----
  217  App\Message\SmsNotification  2019-04-10 22:12:01  ...
  218  App\Message\SmsNotification  2019-04-10 22:12:00  ...
  219  App\Message\SmsNotification  2019-04-10 22:11:59  ...
  ---  ---------------------------  -------------------  -----

  // Run "messenger:failed:show {id} -vv" to see message details

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
$ php bin/console messenger:failed:show 217

  There are 3 messages waiting in the failed transport.

  -----------  ---------------------------
  Class        App\Message\SmsNotification
  Message Id   217
  Failed at    2019-04-10 22:12:01
  Error        ...
  Error Class  Exception
  Transport    async
  -----------  ---------------------------

  Re-run command with "-vv" to see more message & error details.

  Run "messenger:failed:retry 217" to retry this message.
  Run "messenger:failed:purge 217" to delete it.
Help the Symfony project!

As with any Open-Source project, contributing code or documentation is the most common way to help, but we also have a wide range of sponsoring opportunities.

New in Symfony 4.3: Messenger failure transport symfony.com/blog/new-in-symfony-4-3-messenger-failure-transport

Tweet this

Comments

Tac Tacelosky said on May 3, 2019 #1

This looks great! Can you describe how to configure the

dsn: 'doctrine://default?queue_name=failed'

I'm not familiar with this syntax for doctrine.

Ksaveras Šakys Certified said on May 3, 2019 #2

Fantastic, thanks for this feature!

Javier Eguiluz Certified said on May 3, 2019 #3

@Tac the syntax for the Messenger Doctrine transport is explained in this Symfony Docs pull request pending to be merged:

https://github.com/symfony/symfony-docs/pull/10616/files

Laurent VOULLEMIER Certified said on May 3, 2019 #4

Great ! Thank you :)

Tien Vo said on May 6, 2019 #5

Nice feature! Thank you!

btw, ^ (the above comment): is it related to Symfony?

Kamil said on May 24, 2019 #6

Nice to see this feature :)

Comments are closed.

To ensure that comments stay relevant, they are closed for old posts.