Cette page décrit les différents éléments qui ont été mis en place dans PHPBoost pour déboguer du code et ainsi améliorer la qualité du logiciel et gagner en productivité.
Tout d'abord, sachez que peut importe la configuration d'un site PHPBoost, les erreurs, notifications et avertissements trouvés sont stockés dans un fichier de log : /cache/error.log. Celui ci contient toutes les erreurs. Vous pouvez le lire plus facilement en vous rendant dans l'administration -> Outils -> Erreurs archivées
L'activation du mode débogage dans l'administration permet d'afficher explicitement les erreurs lors de la navigation sur le site, ce qui vous évite de travailler avec le fichier error.log.
Le mode à également plusieurs niveau : Normal et Stricte.
Si le mode stricte est activé, il arrête le chargement de la page lorsqu'une erreur est rencontrée.
Debug::fatal(Exception $exception) permet d'afficher les informations sur une exception ainsi que le stacktrace.
Debug::dump($object); affiche les informations $object en clair (ex : la valeur d'un tableau).
Debug::stop($object); Fais la même chose que dump() mais affiche le stacktrace et stoppe lexécution de la page.
Vous avez la possibilité d'activer le mode strict dans les templates en utilisant la fonction enable_strict_mode() sur votre objet Template.
Exemple :
Code PHP :
Affichera les erreurs qui peuvent être présente dans votre fichier tpl ou dans vos déclarations de variable tpl.
Fichier de log des erreurs
Tout d'abord, sachez que peut importe la configuration d'un site PHPBoost, les erreurs, notifications et avertissements trouvés sont stockés dans un fichier de log : /cache/error.log. Celui ci contient toutes les erreurs. Vous pouvez le lire plus facilement en vous rendant dans l'administration -> Outils -> Erreurs archivées
Configuration du débogage
L'activation du mode débogage dans l'administration permet d'afficher explicitement les erreurs lors de la navigation sur le site, ce qui vous évite de travailler avec le fichier error.log.
Le mode à également plusieurs niveau : Normal et Stricte.
Si le mode stricte est activé, il arrête le chargement de la page lorsqu'une erreur est rencontrée.
Utilisation avancée avec la classe Debug
Debug::fatal(Exception $exception) permet d'afficher les informations sur une exception ainsi que le stacktrace.
Debug::dump($object); affiche les informations $object en clair (ex : la valeur d'un tableau).
Debug::stop($object); Fais la même chose que dump() mais affiche le stacktrace et stoppe lexécution de la page.
Déboguer un template
Vous avez la possibilité d'activer le mode strict dans les templates en utilisant la fonction enable_strict_mode() sur votre objet Template.
Exemple :
Code PHP :
$view = new Template('votre_template.tpl'); $view->enable_strict_mode();
Affichera les erreurs qui peuvent être présente dans votre fichier tpl ou dans vos déclarations de variable tpl.