yii2 日记处理

一、实战

1.1、配置

'log' => [
    'traceLevel' => YII_DEBUG ? 3 : 0,
    'targets' => [
        [
            //保存日志消息到文件中
            'class' => 'yii\log\FileTarget',
            //指定记录信息的等级
            'levels' => ['error', 'warning'],
            //向哪个文件输出信息
            'logFile' => '@runtime/logs/output.log',
        ],
    ],
],

1.2、输出

public function actionShowPost($id)
{
    $post = $this->findModel($id);
    $diary = '我是日记';
    //记录一个致命的错误，第一个参数为记录的变量，第二个参数为保存日记的文件名
    \Yii::error($diary,'output.log');
}

输出信息：打开runtime/logs/output.log

2016-11-25 10:28:54 [127.0.0.1][1][-][error][output.log] 我是日记
    in D:\Program Files\phpStudy\WWW\luluyii\modules\post\controllers\DefaultController.php:57
2016-11-25 10:28:54 [127.0.0.1][1][-][info][application] $_GET = [
    'id' => '129'
]

二、更多

2.1、日记消息

Yii::trace()：记录一条消息去跟踪一段代码是怎样运行的。这主要在开发的时候使用。
Yii::info()：记录一条消息来传达一些有用的信息。
Yii::warning()：记录一个警告消息用来指示一些已经发生的意外。
Yii::error()：记录一个致命的错误，这个错误应该尽快被检查。`在这里插入代码片`

这些日志记录方法针对 严重程度 和 类别 来记录日志消息。 它们共享相同的函数签名 function ($message, $category = 'application')，$message代表要被 记录的日志消息，而 $category 是日志消息的类别。在下面的示例代码中，在默认的类别 application 下 记录了一条跟踪消息：

Yii::trace(‘start calculating average revenue’);
注意：日志消息可以是字符串，也可以是复杂的数据，诸如数组或者对象。 log targets 的义务是正确处理日志消息。默认情况下， 假如一条日志消息不是一个字符串，它将被导出为一个字符串，通过调用 yii\helpers\VarDumper::export()

2.2、日志目标 ：一个日志目标是一个 yii\log\Target 类或者它的子类的实例

yii\log\DbTarget：在数据库表里存储日志消息。
yii\log\EmailTarget：发送日志消息到预先指定的邮箱地址。
yii\log\FileTarget：保存日志消息到文件中.
yii\log\SyslogTarget：通过调用PHP函数 syslog() 将日志消息保存到系统日志里。

2.3、消息过滤：yii\log\Target::levels 、yii\log\Target::categories 、yii\log\Target::except

对于每一个日志目标，你可以配置它的 yii\log\Target::levels 和 yii\log\Target::categories 属性来指定哪个消息的严重程度和分类目标应该处理。

yii\log\Target::levels 属性是由一个或者若干个以下值组成的数组：

error：相应的消息通过 Yii::error() 被记录；
warning：相应的消息通过 Yii::warning() 被记录；
info：相应的消息通过 Yii::info() 被记录；
trace：相应的消息通过 Yii::trace() 被记录；
profile：相应的消息通过 Yii::beginProfile() 和 Yii::endProfile() 被记录。

如果你没有指定 yii\log\Target::levels 的属性， 那就意味着目标将处理 任何 严重程度的消息。
yii\log\Target::categories 属性是一个包含消息分类名称或者模式的数组：

一个目标将只处理那些在这个数组中能够找到对应的分类或者其中一个相匹配的模式的消息。
一个分类模式是一个以星号 * 结尾的分类名前缀。
假如一个分类名与分类模式具有相同的前缀， 那么该分类名将和分类模式相匹配。
例如， yii\db\Command::execute 和 yii\db\Command::query 都是作为分类名称运用在 yii\db\Command 类来记录日志消息的。 它们都是匹配模式 yii\db*。
假如你没有指定 yii\log\Target::categories 属性， 这意味着目标将会处理 任何 分类的消息。
除了通过 yii\log\Target::categories 属性设置白名单分类，你也可以通过 yii\log\Target::except 属性来设置某些分类作为黑名单。

在下面的目标配置中指明了目标应该只处理错误和警告消息，
当分类的名称匹配 yii\db* 或者是 yii\web\HttpException:* 的时候， 但是除了

yii\web\HttpException:404。
[
    'class' => 'yii\log\FileTarget',
    'levels' => ['error', 'warning'],
    'categories' => [
        'yii\db\*',
        'yii\web\HttpException:*',
    ],
    'except' => [
        'yii\web\HttpException:404',
    ],
]

2.4、消息格式化： yii\log\Target::prefix 、 yii\log\Target::logVars

你可以通过配置 yii\log\Target::prefix 的属性来自定义格式，这个属性是一个PHP可调用体返回的自定义消息前缀。 例如，下面的代码配置了一个日志目标的前缀是每个日志消息中当前用户的ID(IP地址和Session ID被删除是由于隐私的原因)。

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

除了消息前缀以外，日志目标也可以追加一些上下文信息到每组日志消息中。 默认情况下，这些全局的PHP变量的值被包含在：$_GET, $_POST, $_FILES, $_COOKIE,$_SESSION 和 $_SERVER 中。 你可以通过配置 yii\log\Target::logVars 属性适应这个行为， 这个属性是你想要通过日志目标包含的全局变量名称。 举个例子，下面的日志目标配置指明了只有 $_SERVER 变量的值将被追加到日志消息中。

[
    'class' => 'yii\log\FileTarget',
    'logVars' => ['_SERVER'],
]

你可以将 logVars 配置成一个空数组来完全禁止上下文信息包含。
或者假如你想要实现你自己提供上下文信息的方式， 你可以重写 yii\log\Target::getContextMessage() 方法。

2.5、消息跟踪级别：yii\log\Dispatcher::traceLevel

在开发的时候，通常希望看到每个日志消息来自哪里。这个是能够被实现的，通过配置 log 组件的 yii\log\Dispatcher::traceLevel 属性， 就像下面这样：

return [
    'bootstrap' => ['log'],
    'components' => [
        'log' => [
            'traceLevel' => YII_DEBUG ? 3 : 0,
            'targets' => [...],
        ],
    ],
];

上面的应用配置设置了 yii\log\Dispatcher::traceLevel 的层级，假如 YII_DEBUG 开启则是3，否则是0。
这意味着，假如 YII_DEBUG 开启，每个日志消息在日志消息被记录的时候， 将被追加最多3个调用堆栈层级；
假如 YII_DEBUG 关闭， 那么将没有调用堆栈信息被包含。

2.6、消息刷新和导出： yii\log\Dispatcher::flushInterval、yii\log\Target::exportInterval

如上所述，通过 yii\log\Logger 对象，日志消息被保存在一个数组里。 为了这个数组的内存消耗，当数组积累了一定数量的日志消息， 日志对象每次都将刷新被记录的消息到 log targets 中。 你可以通过配置 log 组件的 yii\log\Dispatcher::flushInterval 属性来自定义数量：

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

当 yii\log\Logger 对象刷新日志消息到 log targets 的时候，它们并 不能立即获取导出的消息。相反，消息导出仅仅在一个日志目标累积了一定数量的过滤消息的时候才会发生。你可以通过配置 个别的 log targets 的 yii\log\Target::exportInterval 属性来 自定义这个数量，就像下面这样：

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

因为刷新和导出层级的设置，默认情况下，当你调用 Yii::trace() 或者任何其他的记录方法，你将不能在日志目标中立即看到日志消息。 这对于一些长期运行的控制台应用来说可能是一个问题。为了让每个日志消息在日志目标中能够立即出现， 你应该设置 yii\log\Dispatcher::flushInterval 和 yii\log\Target::exportInterval 都为1， 就像下面这样：

return [
    'bootstrap' => ['log'],
    'components' => [
        'log' => [
            'flushInterval' => 1,
            'targets' => [
                [
                    'class' => 'yii\log\FileTarget',
                    'exportInterval' => 1,
                ],
            ],
        ],
    ],
];

2.7、切换日志目标： yii\log\Target::enabled

你可以通过配置 yii\log\Target::enabled 属性来开启或者禁用日志目标。 你可以通过日志目标配置去做，或者是在你的代码中放入下面的PHP申明：

Yii::$app->log->targets['file']->enabled = false;

上面的代码要求您将目标命名为 file，像下面展示的那样， 在 targets 数组中使用字符串键：

return [
    'bootstrap' => ['log'],
    'components' => [
        'log' => [
            'targets' => [
                'file' => [
                    'class' => 'yii\log\FileTarget',
                ],
                'db' => [
                    'class' => 'yii\log\DbTarget',
                ],
            ],
        ],
    ],
];

2.8、创建新的目标

创建一个新的日志目标类非常地简单。你主要需要实现 yii\log\Target::export() 方法来发送 yii\log\Target::messages 数组的 内容到一个指定的媒体中。你可以调用 yii\log\Target::formatMessage() 方法去格式化每个消息。

2.9、性能分析

性能分析是一个特殊的消息记录类型，它通常用在测量某段代码块的时间， 并且找出性能瓶颈是什么。

举个例子，yii\db\Command 类 使用性能分析找出每个数据库查询的时间。

为了使用性能分析，首先确定需要进行分析的代码块。 然后像下面这样围住每个代码块：

\Yii::beginProfile('myBenchmark');
...code block being profiled...
\Yii::endProfile('myBenchmark');

这里的 myBenchmark 代表一个唯一标记来标识一个代码块。
之后当你检查分析结果的时候， 你将使用这个标记来定位对应的代码块所花费的时间。
对于每个被分析的代码块，一个带有严重程度 profile 的日志消息被记录。
你可以配置一个 log target 去收集这些 消息，并且导出他们。Yii debugger 有一个内建的性能分析面板能够展示分析结果。