PHP 的異常處理、錯誤的拋出及錯誤回呼函數

標籤：function   編譯   自訂   dir   load   說明   啟用   etl   記憶體配置   

一、錯誤、異常 等級常量表

error：不能在編譯期發現的運行期錯誤，不如試圖用 echo 輸出一個未賦值的變數，這類問題往往導致程式或邏輯無法繼續下去而需要中斷；

exception：程式執行過程中出現意料之外的情況，邏輯上往往是行得通的，但不符合應用情境，比如接收到一個長度超出預定格式的使用者命名，因此，異常主要靠編碼人員做預先做判斷後拋出，捕獲異常後改變程式流程來處理這些情況，不必中斷程式。

 PHP 對於異常和錯誤的界定似乎不是很明顯，尤其是低版本的PHP。

 

錯誤和日誌記錄值    常量                            說明                                              備忘
1                  E_ERROR (integer)     致命的執行階段錯誤。          |這類錯誤一般是不可恢複的情況，例如記憶體配置導致的問題。後果是導致指令碼終止不再繼續運行。  

2                  E_WARNING (integer)   運行時警告 (非致命錯誤)。  |僅給出提示資訊，但是指令碼不會終止運行。  

4                  E_PARSE (integer)     編譯時間文法解析錯誤。          |解析錯誤僅僅由分析器產生。  

8                  E_NOTICE (integer)   運行時通知。                   |表示指令碼遇到可能會表現為錯誤的情況，但是在可以正常啟動並執行指令碼裡面也可能會有類似的通知。  

16                E_CORE_ERROR(integer)   PHP初始化啟動過程中發生的致命錯誤。  |該錯誤類似 E_ERROR，但是是由PHP引擎核心產生的。since PHP 4

32                E_CORE_WARNING(integer)   PHP初始化啟動過程中發生的警告 (非致命錯誤) 。 |類似 E_WARNING，但是是由PHP引擎核心產生的。since PHP 4

64                E_COMPILE_ERROR(integer)   致命編譯時間錯誤。          |類似E_ERROR, 但是是由Zend指令碼引擎產生的。since PHP 4

128              E_COMPILE_WARNING(integer)    編譯時間警告 (非致命錯誤)。  |類似 E_WARNING，但是是由Zend指令碼引擎產生的。since PHP 4

256              E_USER_ERROR(integer)       使用者產生的錯誤資訊。        |類似 E_ERROR, 但是是由使用者自己在代碼中使用PHP函數 trigger_error()來產生的。since PHP 4

512              E_USER_WARNING(integer)   使用者產生的警告資訊。         |類似 E_WARNING, 但是是由使用者自己在代碼中使用PHP函數 trigger_error()來產生的。since PHP 4

1024            E_USER_NOTICE(integer)   使用者產生的通知資訊。        |類似 E_NOTICE, 但是是由使用者自己在代碼中使用PHP函數 trigger_error()來產生的。since PHP 4

2048            E_STRICT (integer)         啟用 PHP 對代碼的修改建議。       |確保代碼具有最佳的互通性和向前相容性， since PHP 5

4096            E_RECOVERABLE_ERROR(integer)   可被捕捉的致命錯誤。   |它表示發生了一個可能非常危險的錯誤，但是還沒有導致PHP引擎處於不穩定的狀態。 如果該錯誤沒有被使用者自訂控制代碼捕獲 (參 見 set_error_handler())，將成為一個 E_ERROR　從而指令碼會終止運行。since PHP 5.2.0

8192            E_DEPRECATED(integer)        運行時通知。               |啟用後將會對在未來版本中可能無法正常工作的代碼給出警告。since PHP 5.3.0

16384          E_USER_DEPRECATED(integer)    戶產少的警告資訊。   |類似 E_DEPRECATED, 但是是由使用者自己在代碼中使用PHP函數 trigger_error()來產生的。since PHP 5.3.0

30719          E_ALL (integer)               E_STRICT出外的所有錯誤和警告資訊。    

 

*30719 in PHP 5.3.x, 6143 in PHP 5.2.x, 2047 previously

 

二、error_reporting() 及 try-catch、thrown 

error_reporting() 函數可以擷取(不傳參時)、設定指令碼處理哪些異常(並非所有異常都需要處理，例如 E_CORE_WARNING、E_NOTICE、E_DEPRECATED 是可以忽略的)，該設定將覆蓋 php.ini 中 error_reporting 選項定義的異常處理設定。

例如：

error_reporting(E_ALL&~E_NOTICE) ; // 除了E_NOTICE其他異常都會被觸發 （E_ALL&~E_NOTICE 的二進位運算結果是：E_NOTICE對應位的值被設定為0,應注意到，錯誤和日誌記錄值都是一個位元,某一位設定為1）

 

try-catch 無法在類的自動載入函數 __autoload() 內生效。

try-catch 用於捕獲異常，無法捕獲錯誤，例如 trigger_error() 觸發的錯誤，異常和錯誤是不一樣的。

 

try{  // you codes that maybe cause an error}catch(Exception $err){ // 這個錯誤對象需要宣告類型， Exception 是系統預設異常處理類    echo $err->getMessage();} //thrown 可以拋出一個異常，如：thrown new Exception(‘an error‘);

 

一個例子：

try {    if ( empty( $var1 ) ) throw new NotEmptyException();    if ( empty( $var2 ) ) throw new NotEmptyException();    if ( ! preg_match() ) throw new InvalidInputException();    $model->write();    $template->render( ‘success‘ );  } catch ( NotEmptyException $e ) {  $template->render( ‘error_empty‘ );} catch ( InvalidInputException $e ) {  $template->render( ‘error_preg‘ );}

 

 

Exception 類的結構：其中大部分方法都是 禁止改寫的（final ）

Exception {/* 屬性 */protected string $message ;protected int $code ;protected string $file ;protected int $line ;/* 方法 */public __construct ([ string $message = "" [, int $code = 0 [, Exception $previous = null]]] )final public string getMessage ( void ) //異常拋出的資訊final public Exception getPrevious ( void ) //前一異常final public int getCode ( void ) //異常代碼，這是使用者自訂的final public string getFile ( void ) //發生異常的檔案路勁final public int getLine ( void ) //發生異常的行final public array getTrace ( void ) //異常追蹤資訊(array)final public string getTraceAsString ( void ) //異常追蹤資訊(string)public string __toString ( void ) //試圖直接 將異常對象當作字串使用時調用子函數的傳回值final private void __clone ( void ) //複製異常對象時調用}

  

擴充異常類

try-catch 可以有多個 catch 子句，從第一個 catch 子句開始，如果子句內的 異常變數 類型匹配 thrown 語句拋出的異常類型，則該子句會被執行而不再執行其他catch子句，否則繼續嘗試下一個 catch 子句，由於Exception 是所有 異常類的基類，因此拋出的異常都會與他匹配 ，如果需要根據不同異常類型使用不同的處理方法，應該將 Exception 類型的 catch 子句放到最後。 

 

Exception 是所有異常的基類，可以根據實際需要擴充異常類

calss MyException extends Exception{   public errType = ‘default‘;   public function __construct($errType=‘‘){      $this->errType = $errType;  }} try{  // you codes that maybe cause an error   thrown new MyException(‘an error‘);}catch(MyException $err){ // 這個錯誤對象需要宣告類型    echo $err->errType(); }catch(ErrorException $err){ //ErrorException 是 PHP 5 增加的異常類以便將錯誤封裝為異常，可以更好地處理錯誤資訊，繼承於 Exception   echo ‘error !‘; }catch(Exception $err){   redirect(‘/error.php‘); }

  

你可能會在 catch 子句中判斷異常的類型，或者根據 code 等資訊來決定是否處理異常，如果你寫在 catch 子句的代碼無法適當的處理捕獲的異常，你可以在 catch 子句內繼續 拋出異常。

 

三 、 Exception 異常的回呼函數

set_exception_handler(‘exceptionHandlerFun‘)  //發生 Exception 或其 子類的 異常是會調用此函數function exceptionHandlerFun($errObj){  // Exception 異常的回呼函數 只有一個參數，就是拋出的異常對象。 //.......}

 

 Exception 異常的回呼函數並不能像  set_error_handler 的回呼函數那樣通過返回 true 來使異常被消除，即使回呼函數處理了異常，後繼代碼也不會被繼續執行，因此想繼續執行後續代碼必須使用 try-catch，在 try-catch 內被捕獲的異常不會觸發 exception_handler。

 

但是有一個例外：拋出的異常即使沒有被處理，指令碼結束回呼函數可以被執行。

 

register_shutdown_function(callback functionName[,argument1,argument2,...]);

例如：

function shutdownfunction(){    echo ‘script is end‘;}register_shutdown_function("shutdownfunction");　

 

因為 shutdownfunction() 在指令碼結束時被執行，所以 這個回呼函數之內可以呼叫指令碼中任意位置的函數，即使該函數定義在 錯誤拋出位置之後(函數定義是在 指令碼編譯期完成的)。

 

四、trigger_error(string errorMsg[,int user_error_type]) 

 該函數用於主動觸發一個錯誤： user_error_type 只能是 E_ALL、E_USER_ERROR、 E_USER_WARNING、 E_USER_NOTICE 或其組合的值。

 

註冊 error (包括系統拋出的 Error 和 使用者拋出的 Error )的處理函數和消除 error：

set_error_handler(callback functionName[,user_error_type]); // 為 trigger_error() 設定一個回呼函數來處理錯誤，包括系統拋出的錯誤和使用者使用 trigger_error() 函數觸發的錯誤。 

 

選擇性參數 user_error_type ：

如果設定此參數，則 trigger_error 拋出的錯誤類型符合 在user_error_type 的定義範圍才能觸發回呼函數。

這個值的設定類似於 error_reporting() 函數 。

 

第一個參數（callbeck functionName）：

一個函數名，該函數 可以有 5 個參數，其中前 2 個必選，依次是：

trigger_error 拋出的 user_error_type、trigger_error 拋出的 errorMsg、拋出錯誤的檔案的絕對路勁、拋出錯誤的行號、拋出錯誤時的上下文環境 (一個數組，包含了trigger_error() 所在範圍內的所有變數、函數、類等資料 )

回呼函數的傳回值： 如果返回 false ，系統錯誤處理機制仍然繼續拋出該錯誤，返回 true 或 無傳回值 則消除錯誤。

 

你可以使用 set_error_handler() 來將 PHP 程式 拋出的錯誤代理給 ErrorException使錯誤可以類似異常那樣顯示：

function error_handler($errorType, $errorMsg, $errorFile, $errorLine ) {    echo ‘<div style="color:red;">error_handler is called!</div>‘;    throw new ErrorException($errorMsg, 0, $errorType, $errorFile, $errorLine);}set_error_handler(‘error_handler‘);count();

 

 使用者使用 trigger_error()  觸發的錯誤不會被 try-catch 異常捕獲語句捕獲。

PHP 的異常處理、錯誤的拋出及錯誤回呼函數 （轉）