Yii 消息

Yii提供了一个高度可定制和可扩展的框架。借助此框架,您可以轻松记录各种类型的消息。

要记录消息,您应该调用以下方法之一 -

  • Yii :: error() - 记录致命的错误消息。

  • Yii :: warning() - 记录一条警告消息。

  • Yii :: info() - 用一些有用的信息记录消息。

  • Yii :: trace() - 记录消息以跟踪代码的运行方式。

上述方法记录各种类别的日志消息。他们共享以下功能签名 -

function ($message, $category = 'application')

哪里 -

  • $ message - 要记录的日志消息

  • $ category - 日志消息的类别

一个简单而方便的命名方案是使用PHP METHOD魔术常数。例如 -

Yii::info('this is a log message', __METHOD__);

日志目标是yii \ log \ Target类的一个实例。它按类别过滤所有日志消息,并将它们导出到文件,数据库和/或电子邮件。

第1步 - 您也可以注册多个日志目标。

return [
   // the "log" component is loaded during bootstrapping time
   'bootstrap' => ['log'],
   'components' => [
      'log' => [
         'targets' => [
            [
               'class' => 'yii\log\DbTarget',
               'levels' => ['error', 'warning', 'trace', 'info'],
            ],
            [
               'class' => 'yii\log\EmailTarget',
               'levels' => ['error', 'warning'],
               'categories' => ['yii\db\*'],
               'message' => [
                  'from' => ['log@mydomain.com'],
                  'to' => ['admin@mydomain.com', 'developer@mydomain.com'],
                  'subject' => 'Application errors at mydomain.com',
               ],
            ],
         ],
      ],
   ],
];

在上面的代码中,注册了两个目标。第一个目标选择所有错误,警告,跟踪和信息消息并将它们保存在数据库中。第二个目标将所有错误和警告消息发送到管理员电子邮件。

Yii提供了以下内置的日志目标 -

  • yii \ log \ DbTarget - 将日志消息存储在数据库中。

  • yii \ log \ FileTarget - 将日志消息保存在文件中。

  • yii \ log \ EmailTarget - 将日志消息发送到预定义的电子邮件地址。

  • yii \ log \ SyslogTarget - 通过调用PHP函数syslog()将日志消息保存到syslog。

默认情况下,日志消息格式如下 -

Timestamp [IP address][User ID][Session ID][Severity Level][Category] Message Text

第2步 - 要自定义此格式,您应该配置 yii \ log \ Target :: $前缀 属性。例如。

[
   'class' => 'yii\log\FileTarget',
   'prefix' => function ($message) {
      $user = Yii::$app->has('user', true) ? Yii::$app->get('user') :
      'undefined user';
      $userID = $user ? $user->getId(false) : 'anonym';
      return "[$userID]";
   }
]

上面的代码片段配置一个日志目标,将所有日志消息加上当前用户标识。

默认情况下,日志消息包含来自这些全局PHP变量的值:$ _GET,$ _POST,$ _SESSION,$ _COOKIE,$ _FILES和$ _SERVER。要修改此行为,应该使用要包含的变量的名称配置 yii \ log \ Target :: $ logVars 属性。

记录器对象将所有日志消息保存在一个数组中。每次数组累积一定数量的消息(默认值为1000)时,记录器对象将记录的消息刷新到日志目标。

第3步 - 要自定义此号码,您应该调用 flushInterval属性

return [
   'bootstrap' => ['log'],
   'components' => [
      'log' => [
         'flushInterval' => 50, // default is 1000
         'targets' => [...],
      ],
   ],
];

即使记录器对象将日志消息刷新到日志目标,它们也不会立即导出。当日志目标累积一定数量的消息时(默认值为1000),就会进行导出。

第4步 - 要自定义此编号,您应该配置 exportInterval 属性。

[
   'class' => 'yii\log\FileTarget',
   'exportInterval' => 50, // default is 1000
]

第5步 - 现在,以 这种方式修改 config / web.php 文件。

<?php
   $params = require(__DIR__ . '/params.php');
   $config = [
      'id' => 'basic',
      'basePath' => dirname(__DIR__),
      'bootstrap' => ['log'],
      'components' => [
         'request' => [
            // !!! insert a secret key in the following (if it is empty) - this
               //is required by cookie validation
            'cookieValidationKey' => 'ymoaYrebZHa8gURuolioHGlK8fLXCKjO',
         ],
         'cache' => [
            'class' => 'yii\caching\FileCache',
         ],
         'user' => [
            'identityClass' => 'app\models\User',
            'enableAutoLogin' => true,
         ],
         'errorHandler' => [
            'errorAction' => 'site/error',
         ],
         'mailer' => [
            'class' => 'yii\swiftmailer\Mailer',
            // send all mails to a file by default. You have to set
            // 'useFileTransport' to false and configure a transport
            // for the mailer to send real emails.
            'useFileTransport' => true,
         ],
         'log' => [
            'flushInterval' => 1,
            'traceLevel' => YII_DEBUG ? 3 : 0,
            'targets' => [
               [
                  'class' => 'yii\log\FileTarget',
                  'exportInterval' => 1,
                  'logVars' => []
               ],
            ],
         ],
         'db' => require(__DIR__ . '/db.php'),
      ],
      'modules' => [
         'hello' => [
            'class' => 'app\modules\hello\Hello',
         ],
      ],
      'params' => $params,
   ];
   if (YII_ENV_DEV) {
      // configuration adjustments for 'dev' environment
      $config['bootstrap'][] = 'debug';
      $config['modules']['debug'] = [
         'class' => 'yii\debug\Module',
      ];
      $config['bootstrap'][] = 'gii';
      $config['modules']['gii'] = [
         'class' => 'yii\gii\Module',
      ];
   }
   return $config;
?>

在上面的代码中,我们定义了日志应用程序组件,将 flushIntervalexportInteval 属性设置为1,以便所有日志消息立即出现在日志文件中。我们也忽略了日志目标的levels属性。这意味着所有类别的日志消息(错误,警告,信息,跟踪)都将出现在日志文件中。

第6步 - 然后,在SiteController中创建一个名为actionLog()的函数。

public function actionLog() {
   Yii::trace('trace log message');
   Yii::info('info log message');
   Yii::warning('warning log message');
   Yii::error('error log message');
}

在上面的代码中,我们只是将四个不同类别的日志消息写入日志文件。

第7步 - 在Web浏览器的地址栏中输入URL http:// localhost:8080 / index.php?r = site / log 。日志消息应该出现在app.log文件的app / runtime / logs目录下。

行动日志功能

下一章:Yii 错误处理

Yii包含一个内置的错误处理程序。Yii错误处理程序执行以下操作 -将所有非致命PHP错误转换为可捕获的异常。用详细的调用堆栈显示所有错误和异常。支持不同的错误格式。支持使用控制器操作来显示错误。要禁用错误处理程序,应该在 ...