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

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.