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_logpar TaoLog cette fonctionnalité est obsolète.

L'enregistreur peut être configuré dans config/generis/log.conf.phpet 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();