Mettre le système en mode de débogage
Comment configurer TAO en mode débogage pour la journalisation et le dépannage.
Lorsque vous essayez de localiser une erreur que vous rencontrez, il est important de configurer votre système en mode débogage pour augmenter la quantité d'informations dans vos journaux.
Pour ce faire, vous devrez SSH
sur votre serveur, et ensuite cd
à l'endroit où vous avez installé TAO. Vous allez ensuite éditer config/generis.conf.php et assurez-vous que DEBUG_MODE
est réglé sur true
comme indiqué ci-dessous :
// mode
define('DEBUG_MODE', true);
Si vous avez besoin d'un enregistrement plus détaillé, TAO possède un enregistreur qui accepte un fichier Interface de l'enregistreur PSR-3. L'enregistreur utilise TaoMonoLog qui est une enveloppe pour monolog. Bien qu'il y ait une compatibilité ascendante avec common_log
par TaoLog cette fonctionnalité est obsolète.
L'enregistreur peut être configuré dans config/generis/log.conf.php
et contient plusieurs exemples. Ces exemples peuvent être utilisés pour configurer diverses méthodes de diffusion des journaux vers un fichier, une console web, Slack, etc.
Les niveaux de journalisation utilisés par l'enregistreur sont les suivants :
- DEBUG (100) : Informations de débogage détaillées.
- INFO (200) : Événements intéressants. Exemples : L'utilisateur se connecte, les journaux SQL.
- AVIS (250) : Événements normaux mais significatifs.
- AVERTISSEMENT (300) : Occurrences exceptionnelles qui ne sont pas des erreurs. Exemples :
Utilisation d'API dépréciées, mauvaise utilisation d'une API, choses indésirables qui ne sont pas
nécessairement mauvaises. - ERREUR (400) : Les erreurs d'exécution qui ne nécessitent pas d'action immédiate mais qui
mais qui doivent être consignées et surveillées. - CRITIQUE (500) : Conditions critiques. Exemple : Composant de l'application
indisponible, exception inattendue. - ALERTE (550) : Une action doit être entreprise immédiatement. Exemple : Tout le site web
en panne, base de données indisponible, etc. Cela devrait déclencher les alertes SMS et vous
et vous réveiller. - URGENCE (600) : Urgence : le système est inutilisable.
Voici un exemple de configuration de config/generis/log.conf.php
pour envoyer déboguer dans un fichier, dans ce cas-ci /var/www/html/tao/logs/test-log.log :
return new oat\oatbox\log\LoggerService(array(
'logger' => array(
'class' => \oat\oatbox\log\logger\TaoMonolog::class,
'options' => array(
'name' => 'tao',
'handlers' => array(
array(
'class' => \Monolog\Handler\StreamHandler::class,
'options' => array(
'/var/www/html/tao/logs/test-log.log',
\Monolog\Logger::DEBUG
)
)
)
)
)));
return new oat\oatbox\log\LoggerService();