yiiapi/docs/guide/zh_tw/topics.logging.txt

这里只显示每个文件的开头 60 行。登录后可以解锁完整代码。

微信扫码关注公众号，代码整理好后第一时间通知你。

日誌記錄
=======

Yii 提供了一個靈活可擴充的日誌功能。記錄的日誌
可以通過日誌級別和訊息分類進行歸類。通過使用
級別和分類篩選器，所選的訊息還可以進一步路由到
不同的目的地，例如一個檔案、Email和瀏覽器窗口等。


訊息記錄
---------------

訊息可以通過 [Yii::log] 或 [Yii::trace] 記錄。其
區別是後者只在當應用程式程式運行在 [除錯模式(debug mode)](/doc/guide/basics.entry#debug-mode)
中時才會記錄訊息。

~~~
[php]
Yii::log($message, $level, $category);
Yii::trace($message, $category);
~~~

當記錄訊息時，我們需要指定它的分類和級別
分類是一串格式 `xxx.yyy.zzz` 類似於 [路徑別名](/doc/guide/basics.namespace) 的字串。
例如，如果一條訊息是在 [CController] 中記錄的，我們可以使用 `system.web.CController`
作為分類。訊息級別應該是下列值中的一種：

   - `trace`: 這是在  [Yii::trace] 中使用的級別。它用於在開發中
追蹤程式的執行流程。

   - `info`: 這個用於記錄普通的訊息。

   - `profile`: 這個是性能分析。下面馬上會有更詳細的說明。

   - `warning`: 這個用於警告訊息。

   - `error`: 這個用於致命錯誤訊息。


訊息路由
---------------

通過 [Yii::log] 或 [Yii::trace] 記錄的訊息是儲存在記憶體中的。
我們通常需要將它們顯示到瀏覽器窗口中，或者將他們儲存到一些
持久儲存例如檔案和 Email 中。這個就叫作 *訊息路由*，例如，
發送訊息到不同的目的地。

在 Yii 中，訊息路由是由一個叫做 [CLogRouter] 的應用程式元件管理的。
它負責管理一系列稱作 *日誌路由* 的東西。每個日誌路由
代表一個單獨的日誌目的地。通過一個日誌路由發送的訊息會被他們的級別和分類篩選。

要使用訊息路由，我們需要安裝並預先加載一個 [CLogRouter]
應用程式元件。我們也還需要配置它的 
[routes|CLogRouter::routes] 屬性為我們想要的那些日誌路由。
下面的程式碼展示了一個所需的  [應用程式配置](/doc/guide/basics.application#application-configuration)
範例: 

~~~
[php]
array(