和PHP預設的異常處理不同,ThinkPHP拋出的不是單純的錯誤訊息,而是一個人性化的錯誤頁面,下面這篇文章主要給大家介紹了關於ThinkPHP中異常處理的相關資料,文中通過範例程式碼介紹的非常詳細,需要的朋友可以參考下
什麼是異常
從更廣泛的角度來看,例外包含兩個方面,一方面是程式執行時由於語法、執行時間錯誤等導致的異常,一方面時沒有給予正確的回饋,如客戶端要查詢某個產品,沒有查詢到,我認為這也屬於異常的一種。
第一種異常TP框架本身會在頁面中輸出錯誤訊息,但是第二種異常則一般不會輸出任何訊息,所以非常不方便調試。
本文將詳細介紹ThinkPHP異常處理的相關內容,分享出來供大家參考學習,下面話不多說了,來一起看看詳細的介紹吧。
前提環境
現在 PHP 在很多時候是為前端提供接口,所以我們的異常處理也基於這一點進行處理。
在開發階段,TP 原有的異常處理是在頁面中輸出異常訊息,這一點能夠滿足需求,但在生產環境中,則需要以其他方式處理異常。
本文都是針對生產環境的異常處理
AOP 程式設計
現在在許多語言中,都非常流行AOP 程式設計思想,即面向切面程式設計思想,通俗的說,就是用統一的方式處理問題,而不是用相同的方式分別處理多個問題,對於異常處理來說,就是定義統一的異常信息,用統一的方式處理
大致思路
自訂異常處理類,重寫預設異常處理類別的render 方法,然後配置使用自訂異常處理類別處理所有異常
程式碼實作
在根目錄下建立目錄exception,在其下方建立ExceptionHandle.php,此類要繼承handle 類別
#
1 | class ExceptionHandler extends Handle
|
登入後複製
建立幾個屬性,用於定義異常訊息
1 2 3 4 5 6 | private $code ;
private $msg ;
private $errorCode ;
|
登入後複製
覆蓋Handle 類別中的render 方法,當我們在程式碼中使用throw new Exception() 方式拋出異常訊息時,其實就是呼叫了render 方法,所以我們要重寫此方法,以返回我們自己的資訊
1 2 3 4 | public function render(Exception $ex )
{
return json(['msg'=> "自定义异常信息" ]);
nbsp; }
|
登入後複製
下面新控制器Product,新增方法,進行測試
1 2 3 4 5 6 7 8 9 | public function getProduct( $id )
{
try {
3/0;
}
catch (Exception $ex ){
throw $ex ;
}
}
|
登入後複製
然後新增如下路由
##
1 | Route::get( "product/:id" , "api/v1.Product/getProduct" );
|
登入後複製
輸入以下url 測試
http://z.cn/product/2
頁面輸出結果如下

可見,其並沒有執行自訂異常處理函數。
使用自訂的例外處理
在config.php 中修改以下設定
1 2 | 'exception_handle' => 'app\lib\exception\ExceptionHandler',
|
登入後複製
然後再執行

#自訂異常處理類別
一類異常是使用者行為導致的異常,例如沒有查詢到符合條件的資料(從另一個角度來說,這其實不算異常),一類錯誤是執行時間錯誤。而使用者導致的異常可能分為很多種,所以需要自訂相關的類別。
先定義一個父類
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 | class BaseException extends Exception
{
public $code ;
public $msg ;
public $errorCode ;
public function __construct( $params )
{
if (! is_array ( $params )) {
return ;
}
if ( array_key_exists ('code', $params )) {
$this ->code = $params ['code'];
}
if ( array_key_exists ('msg', $params )) {
$this ->msg = $params ['msg'];
}
if ( array_key_exists ('errorCode', $params )) {
$this ->errorCode = $params ['errorCode'];
}
}
}
|
登入後複製
再定義一個處理找不到產品資訊的例外處理類,用來重寫父類別中的各個屬性,而且這個類別中的屬性資訊也可能會被修改,如msg
1 2 3 4 5 6 7 8 9 | class ProductNotFoundException extends BaseException
{
public $code = 404;
public $msg = "请求的产品不存在" ;
public $errorCode = 40000;
}
|
登入後複製
處理不同異常
在render 方法中,根據異常的不同分別處理
1 2 3 4 5 6 | if ( $ex instanceof BaseException) {
} else {
}
|
登入後複製
說明:在throw異常時,會執行render 函數,同時會將拋出的異常物件複製給參數$ex,所以可以根據此參數判斷異常類型
現在的關鍵是生產環境,所以希望返回的異常訊息,前端人員能夠看懂,而不是像上面那樣在頁面中輸出錯誤訊息,還包括堆疊資訊等。
那麼前前端賀後端人員都能夠看懂的資訊一定是json(當然也可以是xml)了,修改render 方法
1 2 3 4 5 6 7 8 9 10 | if ( $ex instanceof BaseException) {
$this ->code = $ex ->code;
$this ->msg = $ex ->msg;
$this ->errorCode = $ex ->errorCode;
} else {
$this ->code = 500;
$this ->msg = "服务器内部错误" ;
$this ->errorCode = 999;
}
|
登入後複製
接著以json 格式傳回錯誤訊息
1 2 3 4 5 6 | $result = [
'msg' => $this ->msg,
'error_code' => $this ->errorCode,
'request_url' => request()->url()
];
return json( $result , $this ->code);
|
登入後複製
#至此,全域的例外處理就寫好了,下面在product.php 中編碼進行測試
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 | public function getProduct( $id )
{
$error =[
'msg'=>'没有找到合适的产品'
];
$ex = new ProductNotFoundException( $error );
throw $ex ;
}
|
登入後複製
提示:生產環境不要忘了將app_debug 修改為false
相關推薦:
tp框架(thinkPHP)實現三次登陸密碼錯誤之後鎖定帳號功能
#Thinkphp5的自訂標籤
#
以上是關於ThinkPHP中的異常處理詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章!