Throw new \Exception(); Oui, mais laquelle ?

De l'importance de prendre soin de ses exceptions.

Conférence donné au ForumPHP 2025.

Transcript

1. Yellow Idea Template for LibreOffice Impress. Credit by : @ealita.id, 2020. Throw new \Exception ; Oui, mais laquelle ?! Olivier Dolbeau https://odolbeau.fr Éleveur d’exceptions en freelance
2. Disclaimer Ma conférence, mes opinions. 😜 !
3. Quoi ? Pourquoi ? Comment ? Conclusion
4. Qu’est-ce qu’une exception ?
5. https://fr.wikipedia.org/wiki/Syst%C3%A8me_de_gestion_d%27exceptions Joker Wikipédia Système de gestion des exceptions […]permet de gérer les conditions exceptionnelles pendant l'exécution du programme. Lorsqu'une exception se produit, l'exécution normale du programme est interrompue [...]. Définition
6. Une exception n’est pas un bug ! L'absence d'un fichier utile n'est pas un bogue du programme. Par contre, ne pas gérer son absence en provoquerait un. Précision Joker Wikipédia (2) https://fr.wikipedia.org/wiki/Syst%C3%A8me_de_gestion_d%27exceptions
7. Pourquoi ce sujet est-il important ?
8. C’quoi l’but ? Ce sont les exceptions qui vont permettre de gérer tous les cas différents du cas nominal. Gérer les « conditions exceptionnelles »
9. Test (très) difficile Que faire quand : • Les données envoyées par un·e utilisateur·ice ne sont pas valides ? • Quand quelqu’un·e appelle mon API sécurisée sans être authentifié·e ? • Quand on essaye de rembourser un paiement qui est déjà remboursé ?
10. Comment bien gérer nos exceptions ?
11. Ça dépend ! Ben oui, sinon ce serait trop facile... !
12. Présentation Une librairie Deux cas de figure Un projet « final » • Maîtrise totale du projet • Connaissance des usages • Besoins très évolutifs • Usages possibles potentiellement variés • Besoin(s) souvent figé(s) ou peu évolutif(s)
13. Comment bien gérer nos exceptions DANS UNE LIBRAIRIE ?
14. Anticiper les cas d’erreurs possibles Permettre aux utilisateur·ices de la librairie de pouvoir traiter n’importe quel cas d’erreur de notre librairie de la manière qui leur conviendra le mieux. ⚠️ Cela ne signifie pas (forcément) créer une exception différente par erreur possible ! ⚠️ Quel est l’objectif ?
15. symfony/http-client Exemple d’une librairie https://github.com/symfony/http-client/tree/7.1/Exception Le contenu de la réponse ne peut pas être « JSON-decoded » Erreur 5xx Erreur 4xx
16. https://fr.wikipedia.org/wiki/Syst%C3%A8me_de_gestion_d%27exceptions symfony/http-client https://excalidraw.com/#json=PM1IX0x_tfBGr505Zh1li,Kpavli0dk2zeLgjEvpMWgg
17. symfony/http-client https://excalidraw.com/#json=1-zfmEEuaFtLWukKu2Drd,AqEDYYoLTJFUtDI5Q9u2aA
18. symfony/http-client https://excalidraw.com/#json=1-zfmEEuaFtLWukKu2Drd,AqEDYYoLTJFUtDI5Q9u2aA
19. symfony/http-client https://excalidraw.com/#json=1-zfmEEuaFtLWukKu2Drd,AqEDYYoLTJFUtDI5Q9u2aA
20. symfony/http-client https://excalidraw.com/#json=1-zfmEEuaFtLWukKu2Drd,AqEDYYoLTJFUtDI5Q9u2aA
21. Comment bien gérer nos exceptions DANS UNE LIBRAIRIE ?
22. GRA-NU-LA-RI-TÉ
23. Pour une librairie 3 règles simples 1) Prévoir suffisamment d’exceptions pour gérer tous les cas d’erreur. 2) Prévoir une exception (une interface) pour les gouverner toutes. 3) Ne jamais lancer une exception qui ne nous appartient pas.
24. Comment bien gérer nos exceptions DANS UN « PROJET FINAL »?
25. Anticiper les cas d’erreurs possibles Permettre aux utilisateur·ices de la librairie de pouvoir traiter n’importe quel cas d’erreur de notre librairie de la manière qui leur conviendra le mieux. ⚠️ Cela ne signifie pas (forcément) créer une exception différente par erreur possible ! ⚠️ Quel est l’objectif ?
26. Gérer les cas d’erreurs prévus / utiles Quel est l’objectif ? Anticiper tous les cas d’erreur est une perte de temps.
27. Un·e utilisateur·ice doit pouvoir supprimer une entité. Sauf le lundi. Exemple métier
28. Quelques problèmes 1) L’entité n’existe pas 2) Prévenir si suppression le lundi
29. 2 problèmes = 2 exceptions Comment ?
30. Exceptions d’un projet Comment choisir son exception ? 1) Utiliser une exception tierce existante 2) Créer une exception spécifique à mon problème 3) Utiliser une exception PHP
31. Utiliser une exception tierce existante Pertinent (à peu près) dès qu’une exception adaptée existe. Exemples : Doctrine\ORM\EntityNotFoundException Doctrine\ORM\NoResultException Symfony\Component\Validator\Exception\ValidationFailedException Cette option est celle à privilégier ! Exception existante
32. Créer une exception spécifique à mon problème Pertinent pour gérer un cas d’erreur métier anticipé (et si la première option n’est pas possible / suffisante). Exemple : si la clôture d’un compte en banque est impossible car il reste des fonds sur le compte, on peut créer une exception « NonEmptyBankAccountException ». ⚠️ Cette option n’est pas le choix par défaut ! ⚠️ Exception spécifique
33. Utiliser une exception PHP Exemples : \RuntimeException \LogicException Option à privilégier si vous n’avez pas besoin d’une exception spécifique ET que vous n’avez pas trouvé d’exception tierce correspondant à votre cas d’erreur. Exception PHP https://www.php.net/manual/fr/reserved.exceptions.php & https://www.php.net/manual/fr/spl.exceptions.php
39. Comment bien gérer nos exceptions DANS UN « PROJET FINAL »?
40. PRAG-MA-TIS-ME
41. Exceptions d’un projet 3 règles simples 1) Réutiliser des exceptions qui ne nous appartiennent pas si c’est pertinent 2) Créer uniquement les exceptions nécessaires pour gérer les cas d’erreur prévus 3) Ne pas tout catcher => Les erreurs 500, c’est bien aussi !
42. Conclusion
43. Conclusion Une librairie 2 cas, 2 mots, 6 règles Un projet « final » GRA-NU-LA-RI-TÉ • Prévoir suffisamment d’exceptions pour gérer tous les cas d’erreur • Prévoir une exception (ou une interface) pour les gouverner toutes • Ne jamais lancer une exception qui ne nous appartient pas PRAG-MA-TIS-ME • Réutiliser des exceptions qui ne nous appartiennent pas si c’est pertinent • Créer uniquement les exceptions nécessaires pour gérer les cas d’erreur prévus • Ne pas tout catcher => Les erreurs 500, c’est bien aussi !
44. Prenez soin de vos exceptions. 😉 Olivier Dolbeau https://odolbeau.fr Éleveur d’exceptions en freelance