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.