11.2 頁面Trace · thinkphp3.1.2

# 頁面Trace [上一頁](131.html "上一頁")[下一頁](133.html "下一頁") 頁面Trace功能是ThinkPHP提供給開發人員的一個用于開發調試的輔助手段。可以實時顯示當前頁面的操作的請求信息、運行情況、SQL執行、錯誤提示等，并支持自定義顯示。頁面Trace功能無論是調試模式還是部署模式都有效，要開啟頁面Trace功能，需要在項目配置文件中設置：`'SHOW_PAGE_TRACE'?=>true,?//?顯示頁面Trace信息`系統默認的Trace信息包括：請求時間、當前頁面、請求協議、運行信息、會話ID、日志記錄和文件加載情況。默認的頁面Trace的顯示如圖所示： ![](https://box.kancloud.cn/2016-01-04_568a2a4a3ab61.png) 新版的頁面Trace信息顯示中已經包含了運行狀態時間顯示，所以開啟頁面Trace功能后無需再開啟運行時間顯示了。我們的建議是運行時間顯示功能用于部署模式需要的時候開啟。**Trace頁面定制** 頁面Trace信息的顯示模板是可以定制的，默認位于系統目錄的Tpl/page_trace.tpl，可以根據項目自身的需要定制，更改TMPL_TRACE_FILE進行配置即可。例如：`'TMPL_TRACE_FILE'?=>?APP_PATH.'Public/trace.php'`關鍵的輸出代碼是：`<?php ????$_trace?=?trace();? ????foreach?($_trace?as?$key=>$info){ ????????echo?$key.'?:?'.$info.' '; ????}`**Trace信息定制** 如果需要擴展自己的Trace信息，有下面幾種方式：第一種方式：在當前項目的配置目錄下面定義 trace.php 文件，返回數組方式的定義，例如：`return?array( ????'當前頁面'=>$_SERVER['PHP_SELF'], ????'通信協議'=>$_SERVER['SERVER_PROTOCOL'],... );`在顯示頁面Trace信息的時候會把這個部分定義的信息合并到系統默認的Trace信息，所以不需要再添加系統默認的頁面trace信息，這種方式通常用于Trace項目的公共信息。第二種方式：在Action方法里面使用trace方法來增加Trace信息，該部分可以用于系統的開發階段調試。例如：`trace('執行時間',$runTime); trace('Name的值',$name); trace('GET變量',dump($_GET,false));`trace方法支持批量設置，例如：`$info['執行時間']=$runTime; $info['Name的值']?=?$name; $info['GET變量']=dump($_GET,false);`trace($info);這種方式的trace信息顯示在頁面Trace信息的最開始。### 3.1版本的頁面Trace 3.1版本對頁面Trace功能進行了增強，更加方便開發過程中的調試，并接管了一部分日志功能。### 使用頁面Trace功能是ThinkPHP框架為開發人員精心設計的一個方便調試的內置行為擴展工具，經歷了多個版本的改進后，由開始的具備簡單頁面信息到現在的全面調試支持。頁面Trace功能分為兩個層面：一、是頁面Trace的顯示界面；二、是提供調試支持的trace方法。要開啟頁面Trace顯示界面，需要開啟SHOW_PAGE_TRACE參數：`'SHOW_PAGE_TRACE'=>true`該配置參數默認關閉。開啟后，頁面的右下角會出現TP的logo，![](https://box.kancloud.cn/2016-01-04_568a2a4a5b62d.png)點擊即可打開頁面Trace窗口。 ![](https://box.kancloud.cn/2016-01-04_568a2a4a6ada5.png) 頁面Trace框架有6個選項卡，分別是基本、文件、流程、錯誤、SQL和調試，點擊不同的選項卡會切換到不同的Trace信息窗口。基本：當前頁面的基本摘要信息，例如執行時間、內存開銷、文件加載數、查詢次數等等。文件：詳細列出當前頁面執行過程中加載的文件及其大小。流程：會列出當前頁面執行到的行為和相關流程（待完善）。錯誤：當前頁面執行過程中的一些錯誤信息，包括警告錯誤。 SQL：當前頁面執行到的SQL語句信息。調試：開發人員在程序中進行的調試輸出。要在調試選項卡中顯示調試信息，則是通過trace方法，該方法可以加到應用程序的任意位置，調用格式如下： **trace('調試變量','顯示標簽')** 例如， trace($user,'用戶信息'); $user變量可能是一個用戶信息數組，那么該變量的值就會顯示到頁面Trace窗口的調試選項卡中。頁面Trace的選項卡是可以定制和擴展的，默認的配置為：`'TRACE_PAGE_TABS'=>array('base'=>'基本','file'=>'文件','think'=>'流程','error'=>'錯誤','sql'=>'SQL','debug'=>'調試')`也就是我們看到的默認情況下顯示的選項卡，如果你希望增加新的選項卡：用戶，則可以修改配置如下：`'TRACE_PAGE_TABS'=>array('base'=>'基本','file'=>'文件','think'=>'流程','error'=>'錯誤','sql'=>'SQL','debug'=>'調試','user'=>'用戶')`我們把剛才的用戶信息調試輸出到用戶選項卡，trace方法的用法修改如下： trace($user,'用戶信息','user'); 第三個參數表示選項卡的標識，和我們在TRACE_PAGE_TABS中配置的對應。默認情況下，頁面Trace窗口顯示的信息是不會保存的，如果希望保存這些trace信息，我們可以配置PAGE_TRACE_SAVE參數：`'PAGE_TRACE_SAVE'=>true`開啟頁面trace信息保存后，每次的頁面Trace信息會以日志形式保存到項目的日志目錄中，命名格式是： **當前日期\_trace.log** 例如：`12-06-21_trace.log`如果不希望保存所有的選項卡的信息，可以設置需要保存的選項卡，例如：`'PAGE_TRACE_SAVE'=>array('base','file','sql');`設置后只會保存base、file和sql三個選項卡的信息。 3.1版本的trace方法不支持批量賦值操作。 [上一頁](131.html "上一頁")[下一頁](133.html "下一頁")