Log - 类別

Log 类别能让你写讯息到纪录档案。

配置

纪录档案被放置在 config.php 的 'log_path' 属性所指定的文件夹。你也可以在那里设定 'log_threshold' 与 'log_date_format' 参数。
这些设定也可以藉由使用 Config 类别 动态地改变。

Fuel::L_WARNING

null

APPPATH.'logs/'

'Y-m-d H:i:s'

用法

有四种预定义的易用函式：

Log::info()
Log::debug()
Log::warning()
Log::error()

它们都使用主要的 Log::write() 函式，此函式需要 $level 参数做为第一个变数。

一些範例：

// 以 "Info" 等级写入一个纪录条目到纪录档案
$var = 1;
Log::info('Application started (with $var = '.$var.')', 'my_init_function()');

// 储存 $var 新的值到纪录档案而不使用 $method 参数
$var = 5;
Log::debug('$var is now '.$var);

// 发送一个警告纪录条目
if($var !== 1) Log::warning('Although $var has been changed, we will keep going.');

// 发送一个错误纪录条目
if($var !== 1) Log::error('We cannot keep going, $var has been changed! :o');

// 最后，建立一个自订 $level 的纪录条目
Log::write('Link', 'More info on http://fuelphp.com/');

输出

所有纪录档案被放置在定义的文件夹中（见上文）。
如果你已经配置了一个档案名称，所有纪录会被写到这个档案。你需要设置你自己的纪录轮换机制 （例如 Linux logrotate）来避免档案变得非常大。如果你还没配置一个档案名称， 纪录档案会在透过目前年其次是月（例如 "2013/06"）命名的文件夹中， 带着日期做为档案名称（例如 "15.php"）揭露。
指向我们的範例纪录档案的完整路径会是：APPPATH.'logs/2011/06/15.php'

上面的範例将会写入以下的程式码到纪录档案：

<?php defined('COREPATH') or exit('No direct script access allowed'); ?>

Info - 2011-01-03 18:44:45 --> my_init_function() - Application started (with $var = 1)
Debug - 2011-01-03 18:44:45 --> $var is now 5
Warning - 2011-01-03 18:44:45 --> Although $var has been changed, we will keep going.
Error - 2011-01-03 18:44:45 --> We cannot keep going, $var has been changed! :o
Link - 2011-01-03 18:44:45 --> More info on http://fuelphp.com/

null

$var = 1;
Log::info('Application started (with $var = '.$var.')', 'my_init_function()');

null

$var = 5;
Log::debug('$var is now '.$var);

null

// 我们发送一个警告纪录条目
if($var !== 1) Log::warning('Although $var has been changed, we will keep going.');

null

// 我们发送一个错误纪录条目
if($var !== 1) Log::error('We cannot keep going, $var has been changed! :o');

null

// 最后，我们以自订 $level 建立一个纪录条目
Log::write('Link', 'More info on http://fuelphp.com/')

程序助手

null

logger(\Fuel::L_INFO, 'My Message', 'SomeMethod');