Attraper lâerreur en production : Sentry et Flare ($)
Les tests attrapent ce que vous avez pensĂ© Ă tester. Lâanalyse statique attrape ce que le systĂšme de types peut prouver. Ni lâun ni lâautre nâattrape ce quâun utilisateur fait Ă 23 h et que personne nâavait prĂ©vu. Le suivi des erreurs, câest la confiance qui continue aprĂšs le bouton de dĂ©ploiement : vous apprenez quâune chose a cassĂ© pour une vraie personne au moment oĂč ça arrive, avec la trace dâappels, au lieu dâun mail au support qui dit « ça ne marche pas ».
Sentry fonctionne avec tous les frameworks de ce livre, avec des SDK pour Laravel, Symfony et PHP nu.
composer require sentry/sentry-laravel
php artisan sentry:publish --dsn=your-dsn-here
try {
$order->submit();
} catch (\Throwable $e) {
\Sentry\captureException($e);
throw $e;
}
Les exceptions non rattrapĂ©es sont capturĂ©es automatiquement une fois le SDK installĂ©. Lâappel manuel ci-dessus sert pour une erreur que vous gĂ©rez proprement mais dont vous voulez quand mĂȘme ĂȘtre informĂ©.
Flare ($), de Spatie, dans lâĂ©cosystĂšme Laravel, se limite Ă Laravel et ajoute Ă chaque rapport le contexte du framework : quelle route, quelle requĂȘte, quel job, Ă cĂŽtĂ© de la trace dâappels.
composer require spatie/laravel-flare
Tarif
Sentry a une offre gratuite utilisable pour les petits projets, puis un plan payant quand le volume dâĂ©vĂ©nements grandit. Flare est un produit payant, avec un essai gratuit mais pas dâoffre gratuite dans la durĂ©e. Les deux portent le $ ici, celui de Sentry plus conditionnel que celui de Flare.
Quand le choisir
Toute application en production. Attendre quâun utilisateur signale un bug quâil ne sait pas dĂ©crire coĂ»te plus de temps de dĂ©bogage que lâabonnement.
Quand ce nâest pas le bon outil
Un prototype, ou un outil interne avec une poignĂ©e dâutilisateurs qui viendront vous voir directement quand quelque chose casse. La mise en place ne se justifie pas encore.
Sous le capot : Ces outils se branchent sur les gestionnaires dâexceptions et dâerreurs de PHP lui-mĂȘme (
set_exception_handler(),set_error_handler()). Câest pour cela que les installer tient en quelques lignes dâamorçage, plutĂŽt quâen une enveloppe autour de chaque appel de fonction de votre application.