Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Laravel : files d’attente et Horizon

Tout ce qui est lent ou accessoire dans une requĂȘte Laravel peut devenir un Job, poussĂ© dans une file d’attente et exĂ©cutĂ© par un processus worker sĂ©parĂ©. La requĂȘte de l’utilisateur se termine tout de suite au lieu d’attendre.

php artisan make:job SendWelcomeEmail
class SendWelcomeEmail implements ShouldQueue
{
    use Queueable;

    public function __construct(private User $user) {}

    public function handle(): void
    {
        Mail::to($this->user)->send(new WelcomeEmail($this->user));
    }
}

// dispatching it
SendWelcomeEmail::dispatch($user);
php artisan queue:work

Cette derniĂšre commande, c’est le worker. Un gestionnaire de processus comme Supervisor le maintient en vie ; il prend les jobs dans la file (Redis, dans la plupart des installations de production) et les exĂ©cute.

Horizon ajoute un tableau de bord par-dessus les files Redis : débit, jobs en échec, relances à la main et métriques par file, sans outil de supervision à part.

composer require laravel/horizon
php artisan horizon:install
php artisan horizon

Les jobs en Ă©chec sont relancĂ©s avec un dĂ©lai croissant. Ceux qui Ă©chouent pour de bon atterrissent dans une table failed_jobs, oĂč vous pouvez les examiner, au lieu de disparaĂźtre.

Quand le choisir

Tout ce qui ne doit pas bloquer une requĂȘte web : envoyer un e-mail, traiter un fichier envoyĂ©, appeler une API tierce lente, gĂ©nĂ©rer un rapport. Si l’utilisateur remarquerait le dĂ©lai, ça va dans une file.

Quand ce n’est pas le bon outil

Le travail qui doit ĂȘtre terminĂ© avant la rĂ©ponse, comme valider un formulaire avant de l’enregistrer. Le mettre en file ajoute de la latence et de la complexitĂ© lĂ  oĂč le code synchrone Ă©tait dĂ©jĂ  juste.

Sous le capot : les jobs sont sĂ©rialisĂ©s (en gĂ©nĂ©ral avec le serialize() natif de PHP) avant d’ĂȘtre rangĂ©s dans la file. C’est pour cela qu’une classe de job ne devrait porter que des propriĂ©tĂ©s simples et sĂ©rialisables, comme l’identifiant d’un modĂšle, plutĂŽt que de gros objets ou des ressources ouvertes ; le worker dĂ©sĂ©rialise et reconstruit le job de zĂ©ro au moment de l’exĂ©cuter.