PHP Master | Implémentation de PSR-3 avec log4php

Implémentation de journalisation PSR-3 avec log4php: un guide pratique

Concepts clés

Cet article montre comment implémenter la norme de journalisation PSR-3 à l'aide de LOG4PHP, un cadre de journalisation open source flexible. Le PSR-3 fournit une interface commune pour les bibliothèques forestières, améliorant l'interopérabilité et la maintenabilité. La configuration de Log4PHP permet d'acheminer différents niveaux de journal (débogage, informations, erreur, etc.) vers diverses destinations de sortie (fichiers, e-mail, etc.).

Configuration des dépendances

Avant de coder, installez les dépendances nécessaires. Vous aurez besoin de l'interface PSR-3 et du framework log4php. Un fichier composer.json comme celui-ci simplifie le processus:

<code class="language-json">{
    "require": {
        "psr/log": "dev-master",
        "apache/log4php": "2.3.0"
    }
}</code>

Création d'un enregistrement conforme PSR-3

Cette classe Logueur personnalisée comble l'interface PSR-3 et les fonctionnalités de Log4PHP, cartographier les niveaux de journal PSR-3 à leurs équivalents log4php:

<code class="language-php"><?php
require_once 'vendor/autoload.php';

use Psr\Log\LoggerInterface as PsrLogLoggerInterface;
use Log4php\Logger;

class MyLogger implements PsrLogLoggerInterface
{
    private $logger;

    public function __construct($loggerName = 'main', $configFile = null) {
        Logger::configure($configFile);
        $this->logger = Logger::getLogger($loggerName);
    }

    // ... (PSR-3 log level methods: emergency, alert, critical, error, warning, notice, info, debug) ...

    // Example method (others similar)
    public function error($message, array $context = array()) {
        $this->logger->error($this->interpolate($message, $context));
    }

    // ... (log() method and interpolate() helper function remain unchanged) ...
}</code>

Cette classe gère les huit niveaux de journal PSR-3, les traduisant en six niveaux log4php (mappant plusieurs niveaux de PSR-3 aux Log4PHP fatal si nécessaire). La fonction interpolate() (tirée de l'exemple de l'implémentation PSR-3) gère les variables de contexte dans les messages journaux.

Configuration de log4php

log4php utilise une configuration par défaut, mais vous pouvez le personnaliser avec XML ou PHP. Un fichier de configuration XML (config.xml) peut ressembler à ceci pour enregistrer les avertissements et supérieur à un fichier:

<code class="language-xml"><configuration xmlns="http://logging.apache.org/log4php/">
  <appender name="myAppender" class="LoggerAppenderFile">
    <param name="file" value="myLog.log">
    <layout class="LoggerLayoutSimple"></layout>
  </appender>
  <root>
    <level value="WARN"></level>
    <appender_ref ref="myAppender"></appender_ref>
  </root>
</configuration></code>

Pour utiliser cette configuration, passez le chemin du fichier au constructeur MyLogger:

<code class="language-php">$logger = new MyLogger('main', 'config.xml');
$logger->debug('This debug message will be ignored.');
$logger->warn('This warning will be logged to myLog.log');</code>

Conclusion

L'intégration du PSR-3 avec Log4PHP fournit une solution de journalisation standardisée et flexible. La capacité de diriger différents niveaux de journal à des sorties spécifiques facilite le débogage et la surveillance des applications. Pour plus de détails, consultez le Guide de démarrage rapide LOG4PHP et la norme PSR-3 sur GitHub.

Questions fréquemment posées (reformatées pour la clarté et la concision):

• PSR-3 Signification: PSR-3 Standardalise les interfaces de journalisation, permettant une échange facile des bibliothèques de journalisation sans modifications de code.

• En commençant par log4php: Configurer les annexes, les mises en page et les journalistes (fichier XML, PHP ou Propriétés), puis créez une instance d'enregistrement pour enregistrer les messages.

• Installation: Télécharger à partir des services de journalisation Apache ou utiliser composer (composer require apache/log4php).

• Configuration: Utilisez des fichiers XML, PHP ou Propriétés pour définir les annexes (destinations de sortie), les dispositions (formats de messages) et les journalistes (entités de journalisation nommées).

• plusieurs annexes: Oui, attribuez plusieurs annexes à un enregistreur pour envoyer des journaux à divers emplacements.

• Niveaux logarithmiques: Utiliser debug, info, warn, error et fatal Méthodes pour différents niveaux de gravité.

• Gestion des exceptions: Utilisez LoggerThrowablePatternConverter pour enregistrer les détails de l'exception.

• Intégration du cadre: Fonctionne avec les cadres conformes PSR-3 (Laravel, Symfony, etc.).

• Filtrage: Utiliser la plage de niveau, la correspondance de chaîne ou les filtres de correspondance d'enregistrement pour contrôler la sortie.

• Formatage des messages: Utilisez des dispositions pour personnaliser les formats de messages journaux.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!