Système de journalisation dans le framework Yii : enregistrement des événements d'application-YII-php.cn

Dans le framework Yii, il existe un système de journalisation complet qui peut enregistrer les événements d'application afin que les développeurs puissent effectuer le débogage et l'analyse des performances. Cet article présentera l'utilisation de base du système de journalisation dans le framework Yii et quelques techniques pratiques.

Configuration du composant de journal

Le framework Yii utilise des fichiers comme méthode de stockage des journaux par défaut, et vous pouvez configurer le composant de journal dans le fichier de configuration. Voici un exemple de configuration simple :

'log' => [
    'traceLevel' => YII_DEBUG ? 3 : 0,
    'targets' => [
        [
            'class' => 'yiilogFileTarget',
            'levels' => ['error', 'warning'],
            'logFile' => '@runtime/logs/app.log',
        ],
    ],
],

Copier après la connexion

Parmi eux, traceLevel fait référence au niveau de journalisation enregistré par le framework Yii en mode debug, le plus le niveau est élevé, plus les informations détaillées sont enregistrées. targets est un tableau qui peut configurer plusieurs cibles de journal. Dans cet exemple, il n'y a qu'une seule cible, qui consiste à écrire le niveau erreur et avertissement. se connecte au fichier < code>@runtime/logs/app.log. traceLevel是指Yii框架在debug模式下记录的日志级别，越高则记录的信息越详细。targets是一个数组，可以配置多个日志目标，本例中只有一个目标，即将error和warning级别的日志写入@runtime/logs/app.log文件。

记录日志信息

在代码中记录日志信息很简单，可以使用Yii框架提供的快捷函数，例如：

Yii::info('This is an info message.');
Yii::warning('This is a warning message.');
Yii::error('This is an error message.');

Copier après la connexion

快捷函数中，info、warning和error分别对应日志的三个级别。可以根据情况选择使用。

在记录日志时，除了直接记录字符串以外，还可以使用可替换的数据，使用占位符{}表示。例如：

Yii::info('User {username} registered successfully.', ['username' => 'John']);

Copier après la connexion

此时，{username}将被替换为'John'。这样的好处是日志信息更加详细，更易于排查问题。

使用上下文信息

Yii框架的日志系统支持使用上下文信息来记录更详细的日志信息。上下文信息包括了一些额外的数据，例如当前用户的信息、请求参数等等。在记录日志时，可以通过设置$context参数来添加上下文信息，例如：

Yii::warning('Invalid user input', ['category' => 'appcontrollersMyController', 'action' => 'create', 'params' => $_POST]);

Copier après la connexion

在上述代码中，我们使用了3个上下文信息，分别是所属的控制器类、请求的方法和请求参数。这样就可以更加清晰地了解日志发生的位置以及具体的请求信息。

过滤和分类

在实际应用中，我们可能并不希望记录所有的日志信息。Yii框架的日志系统提供了过滤和分类的机制，可以根据条件过滤和分类日志消息。

在配置中，可以设置categories属性来分类日志消息，例如：

'log' => [
    'targets' => [
        [
            'class' => 'yiilogFileTarget',
            'categories' => ['appcontrollersMyController'],
            'logFile' => '@runtime/logs/mycontroller.log',
        ],
    ],
],

Copier après la connexion

在上述配置中，我们只记录来自appcontrollersMyController控制器的日志信息，并将它们写入@runtime/logs/mycontroller.log文件。

除了分类之外，我们还可以使用函数过滤日志消息，例如：

'log' => [
    'targets' => [
        [
            'class' => 'yiilogFileTarget',
            'levels' => ['error'],
            'logFile' => '@runtime/logs/app.log',
            'logVars' => [],
            'except' => [
                'yiiwebHttpException:404',
            ],
        ],
    ],
],

Copier après la connexion

在上述配置中，我们只记录error级别的日志信息，同时忽略了所有的上下文信息。我们使用了except属性来指定要忽略的日志消息。在此例中，我们忽略了所有的404错误信息。

自定义日志目标

Yii框架的日志系统允许我们自定义日志目标，例如将日志消息发送到email、数据库或者第三方日志服务等等。需要自定义日志目标时，我们需要继承yiilogTarget类，并实现export方法。例如：

class EmailTarget extends yiilogTarget
{
    public $to;

    public function export()
    {
        foreach ($this->messages as $message) {
            mail($this->to, $message[0], $message[1]);
        }
    }
}

Copier après la connexion

在上述代码中，我们定义了一个自定义的邮件目标，并实现了export方法。在export方法中，我们使用mail

L'enregistrement des informations du journal dans le code est très simple. Vous pouvez utiliser les fonctions de raccourci fournies par Yii. framework, tel que :

Dans la fonction raccourci, info, warning et error correspondent aux trois niveaux de journaux respectivement. Vous pouvez choisir de l'utiliser en fonction de la situation.

{}

{username}

$context

categories

appcontrollersMyController

@runtime/logs/mycontroller.log

erreur code> informations de journal au niveau, tout en ignorant toutes les informations contextuelles. Nous utilisons l'attribut <code>sauf

yiilogTarget

export

mail

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!