關於PHP的Yii框架中日誌的相關配置及使用

這篇文章主要介紹了PHP的Yii框架中日誌的相關配置及使用,包括bug追蹤以及資料庫查詢耗時記錄等,需要的朋友可以參考下

預設的日誌是輸出到protected/runtime/application.log

如果需要修改那麼需要在main.php裡面的components 下面增加log配置，如下：

'preload' => array('log'),//这句也必须加上

'components' => array( 
    'log'=>array( 
      'class'=>'CLogRouter', 
      'routes'=>array(
        //这是一个文件route表示category为test开头的所有类型的输出都会记录到runtime/test.log下面 
         array( 
           'class'=>'CFileLogRoute', 
           'levels'=>'trace, info, debug, warn, error, fatal, profile', 
           'categories'=>'test.*', 
           'maxFileSize'=>1048576,//单文件最大1G 
           'logFile'=>'test.log', 
         ), 
         // 
 
//        开发过程中所有日志直接输出到浏览器了，这样不需要登录服务器看日志了  

           
         array( 
          'class' => 'CWebLogRoute', 
          'categories' => 'test.*', 
          'levels' => CLogger::LEVEL_PROFILE, 
          'showInFireBug' => true, 
          'ignoreAjaxInFireBug' => true, 
        ), 
        array( 
          'class' => 'CWebLogRoute', 
          'categories' => 'test.* ', 
        ), 

        array( 
          'class'=>'CEmailLogRoute', 
          'levels'=>'error, warning', 
          'emails'=>'admin@example.com', 
        ), 
      ), 
    ), 
 
  ),

#如果在某處呼叫了Yii::log("jdkshgds","info",'test.xx');

這個log首先被記錄在了記憶體中一個CLogger類別的array中，然後會逐一的判斷每個LogRoute，判斷是否需要輸出，注意是逐一判斷，不是其中一個輸出下一個就不管了。

拿上面的設定來說：

第一個CFileLogRoute，'categories'=>'test.*',levels裡包含了info, test.xx滿足條件，所以會執行，將這條log輸出到test.log中，然後下一個CWebLogRoute， 'levels' => CLogger::LEVEL_PROFILE,。而這log是info的，所以不會執行，再下一個CWebLogRoute，'categories' => 'test.* ',levels沒指定，那就說不過濾，所以這個也會被執行，所以這條log將會被輸出到瀏覽器。

二、profile功能
另外logger還有一個很強大的功能:profile,

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

這樣就能測試這個code block的執行效率了，非常的方便。

更詳細的設定檢視：http://www.yiiframework.com/doc/api/1.1/CProfileLogRoute

然後還有一個很BUG的功能，Profiling SQL Executions

很多時候sql語句寫的不好會非常影響效率的，但是要確定哪一條語句影響了效率就需要profiling了。 YII也提供了這個bug等級的功能。

三、Yii::log()和Yii::trace()的使用
#先在config檔中設定log

##

'log'=>array(
  'class'=>'CLogRouter',
  'routes'=>array(
    array(
      'class'=>'CFileLogRoute',//这表示把日志输出到文件中，下方有详细的
      'levels'=>'error, warning',
    ),
    array(
      'class'=>'CWebLogRoute',//这表示把日志显示在网页下方，下方有详细的
      'levels'=>'trace, info, error, warning',
      'categories'=>'cool.*,system.db.*',
    ),
  ),
),

日誌路由class：

• CDbLogRoute: 將資訊儲存到資料庫的表中。

• CEmailLogRoute: 傳送訊息到指定的 Email 位址。

• CFileLogRoute: 將資訊儲存到應用程式 runtime 目錄中的一個檔案。

• CWebLogRoute: 將 資訊 顯示在目前頁面的底部。

• CProfileLogRoute: 在頁面的底部顯示概述（profiling）資訊。

訊息等級levels：

• trace: 這是在 Yii::trace 中使用的層級。它用於在開發中 追蹤程式的執行流程。

• info: 這個用來記錄普通的資訊。

• profile: 這個是效能概述（profile）。下面馬上會有更詳細的說明。

• warning: 這個用於警告（warning）訊息。

• error: 這個用於致命錯誤（fatal error）訊息。

分類categories：

可以自定義，但在輸出函數裡要對應才會被寫入日誌裡

（例如上邊寫的是cool. * 和system.db.* ，就會把對應分類的資訊寫入日誌，請結合下文來理解）

設定完了，就可以用寫入日誌的函數來記錄了：

Yii::trace('My log message.','cool.pd');
//cool.pd属于cool.*分类，所以会被写入日志
Yii::log('My log message.','info','cool.collectpd');
//log定义级别为info，结合上文，第一个logclass会忽略，不会被写入文件，但会被第二个logclass接收，写入日志在网络下方显示。

trace()和log()的差別：

trace()只會在偵錯模式下生效，也就是開啟debug的時候
trace()不分level，但log ()能設定levels參數

四、偵錯sql query每個語句執行的耗時
在設定中的log下加上下面這個Route

//这个配置专门负责数据库操作的profile 
array( 
    'class'=>'CProfileLogRoute', 
    'levels' => CLogger::LEVEL_PROFILE, 
    'showInFireBug' => true, 
    'ignoreAjaxInFireBug' => true, 
    'categories' => 'system.db.* ', //只记录db的操作日志，其他的忽略 
),

然後在某個controller的某個action中加入：

Yii::beginProfile('db', 'pocketpet'); 
for($i=0;$i<1000;$i++){ 
   $user = UserModel::model()->findByPk("1");//这里只要是数据库操作就行，这个只是个例子 
}

Yii::endProfile(' db', 'pocketpet');

在瀏覽器中存取這個action，記得先開啟firebug，然後firebug就能看到如下圖的記錄：

相同的query會進行歸類，計算total和average，這個對於分析還是非常有幫助的。

也可以將db的日誌寫到文件，配置如下（不建議使用，還是到瀏覽器用firebug方便）：

array( 
  'class'=>'CFileLogRoute', 
  'levels' => CLogger::LEVEL_PROFILE, 
  'categories' => 'system.db.* ', //只记录db的操作日志，其他的忽略 
  'logFile'=>'db.log', 
),

當然，想要生效還得有下面兩步驟設定:

1 . 記得在index.php, 中加入以下設定

$yii = dirname(__FILE__).'/../yii/framework/yii.php';
$config = dirname(__FILE__).'/protected/config/main.php';

defined('YII_DEBUG') or define('YII_DEBUG',true);

defined('YII_DEBUG_SHOW_PROFILER') or define('YII_DEBUG_SHOW_PROFILER',true);
//enable profiling
defined('YII_DEBUG_PROFILING') or define('YII_DEBUG_PROFILING',true);
//trace level
defined('YII_TRACE_LEVEL') or define('YII_TRACE_LEVEL',3);
//execution time
defined('YII_DEBUG_DISPLAY_TIME') or define('YII_DEBUG_DISPLAY_TIME',false);
require_once($yii);
Yii::createWebApplication($config)->run();

2. 在main.php主設定檔裡面，的components db 裡將enableProfiling設定為true

'components' => array(
'db' => array(
    'enableProfiling' => true, //这个是用来记录日志的，会记录每一条语句执行的时间
    'enableParamLogging' => true,//true表示包括sql语句的参数在内的信息都会记录到日志里，非常详细
  ),
)

以上就是本文的全部內容，希望對大家的學習有幫助，更多相關內容請關注PHP中文網！

相關推薦：

關於PHP中Yii框架的常用日誌操作

關於PHP的Yii框架中的日誌功能

#

以上是關於PHP的Yii框架中日誌的相關配置及使用的詳細內容。更多資訊請關注PHP中文網其他相關文章！