首頁 > php框架 > ThinkPHP > 聊聊THINKPHP調試模式及異常處理

聊聊THINKPHP調試模式及異常處理

藏色散人
發布: 2022-01-23 09:29:55
轉載
4791 人瀏覽過

下面thinkphp框架教學欄位將介紹如何開啟THINKPHP 調試模式及異常處理,希望對需要的朋友有幫助!

調試模式

開啟偵錯模式很簡單,只需要在入口文件中增加一行常數定義碼:

<?php
 // 开启调试模式
 define(&#39;APP_DEBUG&#39;, true);
 // 定义应用目录
 define(&#39;APP_PATH&#39;, &#39;./Application/&#39;);
 // 加载框架入口文件
 require &#39;./ThinkPHP/ThinkPHP.php&#39;;
登入後複製

測試時,開啟DEBUG偵錯模式,  開發模式下,自動產生快取文件,測試時自動呼叫快取的文件,會出錯

在完成開發階段部署到生產環境後,只需要關閉調試模式或刪除調試模式定義碼即可切換到部署模式。

<?php
// 关闭调试模式
define(&#39;APP_DEBUG&#39;, false);
// 定义应用目录
define(&#39;APP_PATH&#39;, &#39;./Application/&#39;);
// 加载框架入口文件
require &#39;./ThinkPHP/ThinkPHP.php&#39;;
登入後複製

調試模式的優點在於:

  • 開啟日誌記錄,任何錯誤訊息和調試資訊都會詳細記錄,以便於調試;
  • 關閉模板緩存,模板修改可以即時生效;
  • 記錄SQL日誌,方便分析SQL;
  • 關閉欄位緩存,資料表欄位修改不受快取影響;
  • 嚴格檢查檔案大小寫(即使是Windows平台),幫助你提前發現Linux部署可能導致的隱患問題;
  • 透過頁面Trace功能更好的調試和發現錯誤;
##一旦關閉調試模式,發生錯誤後不會提示特定的錯誤訊息,如果你仍然希望看到特定的錯誤訊息,那麼可以如下設定:

&#39;SHOW_ERROR_MSG&#39;        =>  true,    // 显示错误信息
登入後複製
異常處理

調試模式下面一旦系統發生嚴重錯誤會自動拋出異常,也可以用ThinkPHP內建的E方法手動拋出異常。

E('新增失败');
登入後複製
也可以支援異常代碼(預設為0),例如:

E('信息录入错误',25);
登入後複製
透過設定

TMPL_EXCEPTION_FILE配置參數來修改系統預設的異常模板文件, 例如:

'TMPL_EXCEPTION_FILE' => APP_PATH.'/Public/exception.tpl'
登入後複製
異常模板中可以使用的異常變數有:

$e['file']异常文件名
$e['line'] 异常发生的文件行数
$e['message'] 异常信息
$e['trace'] 异常的详细Trace信息
登入後複製
拋出異常後通常會顯示具體的錯誤訊息,如果不想讓用戶看到具體的錯誤訊息,可以設定關閉錯誤訊息的顯示並設定統一的錯誤提示訊息,例如:

'SHOW_ERROR_MSG' =>    false,
'ERROR_MESSAGE'  =>    '发生错误
登入後複製
配置

ERROR_PAGE參數,把所有異常和錯誤都指向一個統一頁面,從而避免讓使用者看到異常訊息,通常在部署模式下面使用。 ERROR_PAGE參數必須是一個完整的URL位址,例如:

'ERROR_PAGE' =>'/Public/error.html'
登入後複製
如果不在目前域名,還可以指定域名:

'ERROR_PAGE' =>'http://www.myDomain.com/Public/error.html'
登入後複製
注意ERROR_PAGE所指向的頁面不能再使用異常的模板變數了。

日誌記錄

預設情況下只是在偵錯模式記錄日誌,要在部署模式開啟日誌記錄,必須在配置中開啟

LOG_RECORD參數,以及可以在應用程式設定檔中配置需要記錄的日誌級別,例如:

'LOG_RECORD' => true, // 开启日志记录
'LOG_LEVEL'  =>'EMERG,ALERT,CRIT,ERR', // 只记录EMERG ALERT CRIT ERR 错误
登入後複製
日誌級別

#ThinkPHP對系統的日誌按照級別來分類,包括:

  • EMERG 嚴重錯誤,導致系統崩潰無法使用
  • ALERT 警戒性錯誤,必須立即修改的錯誤
  • CRIT 臨界值錯誤,超過臨界值的錯誤
  • ERR 一般性錯誤
  • WARN 警告性錯誤,需要發出警告的錯誤
  • NOTICE 通知,程式可以運行但是還不夠完美的錯誤
  • #INFO 訊息,程式輸出訊息
  • ## DEBUG
  • 偵錯,用於偵錯資訊
  • SQL
  • SQL語句,該層級只在偵錯模式開啟時有效

##記錄方式

日誌的記錄方式預設是檔案方式,可以透過驅動的方式來擴展支援更多的記錄方式。

記錄方式由LOG_TYPE參數配置,例如:

'LOG_TYPE'              =>  'File', // 日志记录类型 默认为文件方式
登入後複製

File方式記錄,對應的驅動程式檔案位於系統的Library/Think/Log/Driver/File.class .php

手動記錄

一般情況下,系統的日誌記錄是自動的,無需手動記錄,但是某些時候也需要手動記錄日誌信息,Log類提供了3個方法用於記錄日誌。

方法 描述
#Log::r​​ecord() 記錄日誌資訊到記憶體
Log::save() #把儲存在記憶體中的日誌資訊(用指定的記錄方式)寫入
Log::write() 即時寫入一條日誌訊息

由于系统在请求结束后会自动调用Log::save方法,所以通常,你只需要调用Log::record记录日志信息即可。

默认记录的日志级别是ERR,也可以指定日志级别:

Think\Log::record('测试日志信息,这是警告级别','WARN');
登入後複製

record方法只会记录当前配置允许记录的日志级别的信息,如果应用配置为:

'LOG_LEVEL'  =>'EMERG,ALERT,CRIT,ERR', // 只记录EMERG ALERT CRIT ERR 错误
登入後複製

那么上面的record方法记录的日志信息会被直接过滤,或者你可以强制记录:

Think\Log::record('测试日志信息,这是警告级别','WARN',true);
登入後複製

采用record方法记录的日志信息不是实时保存的,如果需要实时记录的话,可以采用write方法,例如:

Think\Log::write('测试日志信息,这是警告级别,并且实时写入','WARN');
登入後複製

write方法写入日志的时候 不受配置的允许日志级别影响,可以实时写入任意级别的日志信息。

页面trace

在部署模式下面,显示的调试信息没有调试模式完整,通常我们建议页面Trace配合调试模式一起使用。

要开启页面Trace功能,需要在项目配置文件中设置:

// 显示页面Trace信息
'SHOW_PAGE_TRACE' =>true,
登入後複製

该参数默认为关闭,开启后并且你的页面有模板输出的话,页面右下角会显示ThinkPHP的LOGO:

我们看到的LOGO后面的数字就是当前页面的执行时间(单位是秒) 点击该图标后,会展开详细的页面Trace信息,如图:

页面Trace框架有6个选项卡,分别是基本、文件、流程、错误、SQL和调试,点击不同的选项卡会切换到不同的Trace信息窗口。

选项卡 描述
基本 当前页面的基本摘要信息,例如执行时间、内存开销、文件加载数、查询次数等等。
文件 详细列出当前页面执行过程中加载的文件及其大小。
流程 会列出当前页面执行到的行为和相关流程(待完善)。
错误 当前页面执行过程中的一些错误信息,包括警告错误。
SQL 当前页面执行到的SQL语句信息。
调试 开发人员在程序中进行的调试输出。

页面Trace的选项卡是可以定制和扩展的,默认的配置为:

'TRACE_PAGE_TABS'=>array(
    'base'=>'基本',
     'file'=>'文件',
     'think'=>'流程',
     'error'=>'错误',
     'sql'=>'SQL',
     'debug'=>'调试'
)
登入後複製

把刚才的用户信息调试输出到用户选项卡,trace方法的用法如下:

trace($user,'用户信息','user');
登入後複製

保存这些trace信息,我们可以配置PAGE_TRACE_SAVE参数

'PAGE_TRACE_SAVE'=>true
登入後複製

如果不希望保存所有的选项卡的信息,可以设置需要保存的选项卡,例如:

'PAGE_TRACE_SAVE' => array('base','file','sql');
登入後複製

Trace方法

页面Trace只能用于有页面输出的情况,但是trace方法可以用在任何情况,而且trace方法可以用于AJAX等操作。

Trace方法的格式:

trace('变量','标签','级别','是否记录日志')
登入後複製

例如:

$info = '测试信息';
trace($info,'提示');
登入後複製

如果希望把变量调试输出到页面Trace的某个选项卡里面,可以使用:

trace($info,'提示','user');
登入後複製

如果是输出到ERR选项卡,并且开启 'TRACE_EXCEPTION'=>true的话,

trace($info,'错误','ERR');
登入後複製

会抛出异常。 有三种情况下,trace方法会记录日志:

  • AJAX请求

  • SHOW_PAGE_TRACE为false,也就是页面Trace关闭的情况下

  • trace方法的第四个参数为true

断点调试

凭借强大的页面Trace信息功能支持,ThinkPHP可以支持断点调试功能。 我们只需要在不同的位置对某个变量进行trace输出即可,例如:

 $blog = D("Blog");
 $vo = $blog->create();
 trace($vo,'create vo');
 $vo = $blog->find();
 trace($vo,'find vo');
登入後複製

变量调试

输出某个变量是开发过程中经常会用到的调试方法

用法:

dump($var, $echo=true, $label=null, $strict=true)
登入後複製

相关参数的使用如下:

参数 描述
var(必须) 要输出的变量,支持所有变量类型
echo(可选) 是否直接输出,默认为true,如果为false则返回但不输出
label(可选) 变量输出的label标识,默认为空
strict(可选) 输出变量类型,默认为true,如果为false则采用print_r输出

如果echo参数为false 则返回要输出的字符串

使用示例:

 $Blog = D("Blog");
 $blog = $Blog->find(3);
 dump($blog);
登入後複製

性能调试

G方法可以很方便的获取某个区间的运行时间和内存占用情况。 例如:

G('begin');
// ...其他代码段
G('end');
// ...也许这里还有其他代码
// 进行统计区间
echo G('begin','end').'s';
登入後複製

G('begin','end') 表示统计begin位置到end位置的执行时间(单位是秒),begin必须是一个已经标记过的位置,如果这个时候end位置还没被标记过,则会自动把当前位置标记为end标签,输出的结果类似于:0.0056s

默认的统计精度是小数点后4位,如果觉得这个统计精度不够,还可以设置例如:

G('begin','end',6).'s';
登入後複製

可能的输出会变成:0.005587s

如果你的环境支持内存占用统计的话,还可以使用G方法进行区间内存开销统计(单位为kb),例如:

echo G('begin','end','m').'kb';
登入後複製

第三个参数使用m表示进行内存开销统计,输出的结果可能是:625kb

错误调试

如果需要我们可以使用E方法输出错误信息并中断执行,例如:

//输出错误信息,并中止执行
E($msg);
登入後複製

模型调试

调试执行的SQL语句

在模型操作中 ,为了更好的查明错误,经常需要查看下最近使用的SQL语句,我们可以用getLastsql方法来输出上次执行的sql语句。例如:

$User = M("User"); // 实例化User对象
$User->find(1);
echo $User->getLastSql();
// 3.2版本中可以使用简化的方法
echo $User->_sql();
登入後複製

每个模型都使用独立的最后SQL记录,互不干扰,但是可以用空模型的getLastSql方法获取全局的最后SQL记录

调试数据库错误信息

在模型操作中,还可以获取数据库的错误信息,例如:

$User = M("User"); // 实例化User对象
$result = $User->find(1);
if(false === $result){
    echo $User->getDbError();
}
登入後複製

CURD操作如果返回值为false,表示数据库操作发生错误,这个时候就需要使用模型的getDbError方法来查看数据库返回的具体错误信息。

以上是聊聊THINKPHP調試模式及異常處理的詳細內容。更多資訊請關注PHP中文網其他相關文章!

相關標籤:
來源:csdn.net
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
最新問題
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板