Laravel 12.34 : Le Failover Queue Driver – Quand Redis Tombe, Laravel Continue Sans Faiblir

Dans un monde où les pannes de services cloud comme Redis ou SQS peuvent transformer une application robuste en chaos silencieux, Laravel 12.34 introduit le Failover Queue Driver. Cette fonctionnalité, imaginée et implémentée par Taylor Otwell lui-même, permet à vos jobs de queue de rebondir automatiquement vers un driver de backup si le principal flanche. Plus de jobs perdus, plus d'alertes paniquées à 3h du matin : Laravel gère le failover en toute transparence.

Annoncée le 14 octobre 2025 via un tweet viral de Taylor – "Today's Laravel release introduced a new 'failover' queue driver. It's now super easy to failover to executing jobs synchronously if your primary queue driver is down" – cette feature a déjà conquis la communauté avec plus de 450 likes et 60 reposts. Inspiré par des idées anciennes (comme ce ticket GitHub de 2016), c'est le remède ultime contre les interruptions. Plongeons dans les détails techniques, avec un exemple complet et une explication pas à pas.

#Qu’est-ce que le Failover Queue Driver ?

Le Failover Queue Driver est un wrapper intelligent autour de plusieurs connexions de queue. Il :

• Tente d'abord le driver principal (ex. : Redis pour la vitesse),
• Si ça échoue (timeout, panne, surcharge), bascule automatiquement vers le suivant (ex. : base de données, ou même sync pour une exécution immédiate),
• Continue jusqu'à succès ou épuisement de la liste,
• Déclenche un événement QueueFailedOver pour logger ou alerter sur le basculement.

Avant : Une panne Redis = jobs bloqués ou perdus, workers en panique.
Maintenant : QUEUE_CONNECTION=failover = résilience intégrée, zéro intervention manuelle.

C'est particulièrement puissant en production : imaginez un pic de trafic Black Friday où Redis surchauffe – vos emails transactionnels ou traitements batchs continuent via la DB sans que l'utilisateur ne s'en rende compte.

#1. Configuration : Simple comme Bonjour

#Dans config/queue.php

Ajoutez une connexion failover qui liste vos drivers en ordre de priorité :

 1'connections' => [
 2    // Vos drivers existants
 3    'redis' => [
 4        'driver' => 'redis',
 5        'connection' => 'default',
 6        'queue' => env('REDIS_QUEUE', 'default'),
 7        'retry_after' => 90,
 8        'block_for' => null,
 9    ],
10 
11    'database' => [
12        'driver' => 'database',
13        'table' => 'jobs',
14        'queue' => 'default',
15        'retry_after' => 90,
16        'after_commit' => false,
17    ],
18 
19    'sync' => [
20        'driver' => 'sync',
21    ],
22 
23    // La magie : le failover
24    'failover' => [
25        'driver' => 'failover',
26        'connections' => [
27            'redis',      // Premier choix : rapide et scalable
28            'database',   // Backup : persistant et fiable
29            'sync',       // Dernier recours : synchrone, sans worker
30        ],
31    ],
32],
 1'connections' => [
 2    // Vos drivers existants
 3    'redis' => [
 4        'driver' => 'redis',
 5        'connection' => 'default',
 6        'queue' => env('REDIS_QUEUE', 'default'),
 7        'retry_after' => 90,
 8        'block_for' => null,
 9    ],
10 
11    'database' => [
12        'driver' => 'database',
13        'table' => 'jobs',
14        'queue' => 'default',
15        'retry_after' => 90,
16        'after_commit' => false,
17    ],
18 
19    'sync' => [
20        'driver' => 'sync',
21    ],
22 
23    // La magie : le failover
24    'failover' => [
25        'driver' => 'failover',
26        'connections' => [
27            'redis',      // Premier choix : rapide et scalable
28            'database',   // Backup : persistant et fiable
29            'sync',       // Dernier recours : synchrone, sans worker
30        ],
31    ],
32],

#Dans .env

Définissez-le comme default :

1QUEUE_CONNECTION=failover
1QUEUE_CONNECTION=failover

#Workers : Un par Connexion

Lancez des workers pour chaque driver (sauf sync, qui n'en a pas besoin) :

1php artisan queue:work redis --queue=default
2php artisan queue:work database --queue=default
1php artisan queue:work redis --queue=default
2php artisan queue:work database --queue=default

Astuce : Avec Laravel Horizon, monitorez tout en un dashboard unifié. Les workers non-Redis (comme database) nécessitent des processus séparés.

#2. Comment Ça Marche ? Le Mécanisme Étape par Étape

1. Dispatch d'un Job : Vous appelez dispatch(MyJob::class).
2. Tentative Primaire : Laravel push le job vers redis.
3. Détection d'Échec : Si Redis renvoie une exception (ex. : Connection refused), pas de panique.
4. Basculement Automatique : Essai sur database. Succès ? Job sauvé !
5. Événement Trigger : QueueFailedOver est émis avec détails (connexion échouée, job concerné).
6. Fallback Ultime : Si tout rate, sync exécute le job immédiatement dans le processus courant (mais attention : ça peut ralentir la réponse HTTP).

#Exemple Complet : Gérer une Panne Redis

Imaginons un job SendWelcomeEmail qui envoie un email de bienvenue.

 1// app/Jobs/SendWelcomeEmail.php
 2namespace App\Jobs;
 3 
 4use Illuminate\Bus\Queueable;
 5use Illuminate\Contracts\Queue\ShouldQueue;
 6use Illuminate\Foundation\Bus\Dispatchable;
 7use Illuminate\Queue\InteractsWithQueue;
 8use Illuminate\Queue\SerializesModels;
 9use Illuminate\Support\Facades\Mail;
10 
11class SendWelcomeEmail implements ShouldQueue
12{
13    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
14 
15    public function __construct(public $user) {}
16 
17    public function handle(): void
18    {
19        Mail::to($this->user->email)->send(new \App\Mail\WelcomeMail($this->user));
20    }
21}
 1// app/Jobs/SendWelcomeEmail.php
 2namespace App\Jobs;
 3 
 4use Illuminate\Bus\Queueable;
 5use Illuminate\Contracts\Queue\ShouldQueue;
 6use Illuminate\Foundation\Bus\Dispatchable;
 7use Illuminate\Queue\InteractsWithQueue;
 8use Illuminate\Queue\SerializesModels;
 9use Illuminate\Support\Facades\Mail;
10 
11class SendWelcomeEmail implements ShouldQueue
12{
13    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
14 
15    public function __construct(public $user) {}
16 
17    public function handle(): void
18    {
19        Mail::to($this->user->email)->send(new \App\Mail\WelcomeMail($this->user));
20    }
21}

#Dispatch dans un Contrôleur

 1// app/Http/Controllers/AuthController.php
 2use App\Jobs\SendWelcomeEmail;
 3 
 4public function register(Request $request)
 5{
 6    // ... création user ...
 7 
 8    // Dispatch avec failover automatique
 9    SendWelcomeEmail::dispatch($user);
10 
11    return response()->json(['message' => 'Inscription réussie ! Email en cours...']);
12}
 1// app/Http/Controllers/AuthController.php
 2use App\Jobs\SendWelcomeEmail;
 3 
 4public function register(Request $request)
 5{
 6    // ... création user ...
 7 
 8    // Dispatch avec failover automatique
 9    SendWelcomeEmail::dispatch($user);
10 
11    return response()->json(['message' => 'Inscription réussie ! Email en cours...']);
12}

Si Redis est down :

• Le job atterrit en DB → traité par le worker database.
• L'utilisateur voit une réponse instantanée, sans timeout.

#Écouter l'Événement pour Alerter

 1// app/Providers/EventServiceProvider.php
 2use Illuminate\Queue\Events\QueueFailedOver;
 3use Illuminate\Support\Facades\Event;
 4 
 5Event::listen(QueueFailedOver::class, function (QueueFailedOver $event) {
 6    \Log::warning('Failover activé !', [
 7        'from_connection' => $event->fromConnection,
 8        'job' => $event->job->resolveName(),
 9    ]);
10 
11    // Optionnel : Slack ou email admin
12    // \Illuminate\Support\Facades\Notification::route('slack', 'channel')->notify(new QueueFailoverAlert($event));
13});
 1// app/Providers/EventServiceProvider.php
 2use Illuminate\Queue\Events\QueueFailedOver;
 3use Illuminate\Support\Facades\Event;
 4 
 5Event::listen(QueueFailedOver::class, function (QueueFailedOver $event) {
 6    \Log::warning('Failover activé !', [
 7        'from_connection' => $event->fromConnection,
 8        'job' => $event->job->resolveName(),
 9    ]);
10 
11    // Optionnel : Slack ou email admin
12    // \Illuminate\Support\Facades\Notification::route('slack', 'channel')->notify(new QueueFailoverAlert($event));
13});

#Fonctionnalités Clés du Failover Queue Driver

#Intégration avec Laravel Horizon (Dashboard)

Installez Horizon pour visualiser les failovers :

1composer require laravel/horizon
2php artisan horizon:install
3php artisan horizon
1composer require laravel/horizon
2php artisan horizon:install
3php artisan horizon

Dans l'interface :

• Metrics : Taux de failovers par connexion.
• Failed Jobs : Jobs impactés, avec raison (ex. : "Redis down").
• Tags : Marquez les jobs pour tracer les basculements.

#Pourquoi c’est une Révolution pour la Résilience ?

Taylor l'a prototypé en une matinée le 10 octobre, suite à des idées communautaires datant de 2016. Résultat : un système "set it and forget it" qui sauve des millions de jobs par jour en prod.

#Mise à Jour & Compatibilité

1composer require laravel/framework:^12.34
2php artisan queue:table  # Si DB pas encore configurée
3php artisan migrate
1composer require laravel/framework:^12.34
2php artisan queue:table  # Si DB pas encore configurée
3php artisan migrate

Aucun breaking change. Fonctionne avec tous les drivers officiels. Testez en staging : simulez une panne Redis avec docker stop redis.

Limitations :

• Failover au push seulement (pas au drain des workers).
• Si tous les drivers échouent, le job lève une exception.
• pushRaw() ne trigger pas l'événement (seulement push() et later()).

#Use Cases Réels

1. E-commerce : Panne SQS → fallback DB pour commander processing (millions d'€ en jeu).
2. SaaS : Redis down → sync pour notifications critiques, DB pour batchs.
3. Fintech : Multi-régions : Redis EU → DB US en cas de outage géo.
4. API Heavy : 10k jobs/heure → failover transparent, zéro perte.

#Conclusion

Le Failover Queue Driver transforme Laravel en une forteresse imprenable contre les pannes de queue. Comme le dit Taylor : "super easy to failover" – et c'est vrai. Plus de sueurs froides quand Redis tousse : vos jobs continuent, votre app respire.

Taylor Otwell sur X :
"If your main queue connection is down you can failover to a backup connection, even 'sync'. Thoughts? 🫶"
→ 226 likes, buzz immédiat.

À vous de jouer : Ajoutez 'failover' à votre config/queue.php et dormez tranquille. La résilience n'a jamais été aussi simple.

Liens utiles :

• Documentation officielle – Queue Failover
• Pull Request GitHub
• Laravel Horizon