PHP 例外處理
異常用於在指定的錯誤發(fā)生時改變腳本的正常流程。
異常是什麼?
PHP 5 提供了一個新的物件導(dǎo)向的錯誤處理方法。
異常處理用於在指定的錯誤(異常)情況發(fā)生時改變腳本的正常流程。這種情況稱為異常。
當(dāng)異常被觸發(fā)時,通常會發(fā)生:
· ? 當(dāng)前程式碼狀態(tài)被儲存
· ? 程式碼執(zhí)行被切換到預(yù)先定義(自定義)的異常處理器函數(shù)
· ? 根據(jù)情況,處理器也許會從已儲存的程式碼狀態(tài)重新開始執(zhí)行程式碼,終止腳本執(zhí)行,或從程式碼中另外的位置繼續(xù)執(zhí)行腳本
我們將展示不同的錯誤處理方法:
· ? 例外的基本使用
· ? 建立自訂的例外處理器
· ? 多個例外
· ? 重新拋出例外
· ? 設(shè)定頂層例外處理器
註解:異常應(yīng)該只是在錯誤情況下使用,而不應(yīng)該用於在一個指定的點(diǎn)跳到程式碼的另一個位置。
異常的基本使用
當(dāng)例外被拋出時,其後的程式碼不會繼續(xù)執(zhí)行,PHP 會嘗試尋找符合的"catch" 程式碼區(qū)塊。
如果異常沒有被捕獲,而且又沒用使用set_exception_handler() 作相應(yīng)的處理的話,那麼將發(fā)生一個嚴(yán)重的錯誤(致命錯誤),並且輸出"Uncaught Exception" (未捕獲
異常)的錯誤訊息。
讓我們嘗試拋出一個異常,同時不去捕獲它:
<?php // 創(chuàng)建一個有異常處理的函數(shù) function checkNum($number) { if($number>1) { throw new Exception("Value must be 1 or below"); } return true; } // 觸發(fā)異常 checkNum(2); ?>
#上面的程式碼會得到類似這樣的一個錯誤:
Fatal error: ?Uncaught exception 'Exception' with message 'Value must be 1 or below' in D:\WWW\11.php:7 Stack trace: #0 D:\WWW\11.php(13): checkNum(2) #1 {main} ?thrown in D:\WWW\11.php on line 7
Try、throw 和 catch
要避免上面實(shí)例中出現(xiàn)的錯誤,我們需要創(chuàng)建適當(dāng)?shù)拇a來處理異常。
適當(dāng)?shù)奶幚懋惓4a應(yīng)該包括:
1. ?Try - 使用異常的函數(shù)應(yīng)該位于 "try" 代碼塊內(nèi)。如果沒有觸發(fā)異常,則代碼將照常繼續(xù)執(zhí)行。但是如果異常被觸發(fā),會拋出一個異常。
2. ?Throw - 里規(guī)定如何觸發(fā)異常。每一個 "throw" 必須對應(yīng)至少一個 "catch"。
3. ?Catch - "catch" 代碼塊會捕獲異常,并創(chuàng)建一個包含異常信息的對象。
實(shí)例
讓我們觸發(fā)一個異常:
<?php header("Content-type:text/html;charset=utf-8"); // 創(chuàng)建一個有異常處理的函數(shù) function checkNum($number) { if($number>1) { throw new Exception("變量值必須小于等于 1"); } return true; } // 在 try 塊 觸發(fā)異常 try { checkNum(2); // 如果拋出異常,以下文本不會輸出 echo '如果輸出該內(nèi)容,說明 $number 變量'; } // 捕獲異常 catch(Exception $e) { echo 'Message: ' .$e->getMessage(); } ?>
上面代碼將獲得類似這樣一個錯誤:
Message: 變量值必須小于等于 1
注釋:throw new Exception? 明確的拋出異常
實(shí)例解釋:
上面的代碼拋出了一個異常,并捕獲了它:
1. ? 創(chuàng)建 checkNum() 函數(shù)。它檢測數(shù)字是否大于 1。如果是,則拋出一個異常。
2. ? 在 "try" 代碼塊中調(diào)用 checkNum() 函數(shù)。
3. ? checkNum() 函數(shù)中的異常被拋出。
4. ? catch" 代碼塊接收到該異常,并創(chuàng)建一個包含異常信息的對象 ($e)。
5. ? 通過從這個 exception 對象調(diào)用 $e->getMessage(),輸出來自該異常的錯誤消息。
然而,為了遵循 "每個 throw 必須對應(yīng)一個 catch" 的原則,可以設(shè)置一個頂層的異常處理器來處理漏掉的錯誤。
建立一個自訂的Exception 類別
建立自訂的例外處理程序非常簡單。我們簡單地創(chuàng)建了一個專門的類,當(dāng) PHP 中發(fā)生異常時,可呼叫其函數(shù)。該類別必須是 exception 類別的一個擴(kuò)充。
這個自訂的 exception 類別繼承了 PHP 的 exception 類別的所有屬性,您可以將自訂的函數(shù)新增至其。
我們開始建立exception 類別:
<?php header("Content-type:text/html;charset=utf-8"); class customException extends Exception { public function errorMessage() { // 錯誤信息 $errorMsg = '錯誤行號 '.$this->getLine().' in '.$this->getFile() .': <b>'.$this->getMessage().'</b> 不是一個合法的 E-Mail 地址'; return $errorMsg; } } $email = "someone@example...com"; try { // 檢測郵箱 if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE) { // 如果是個不合法的郵箱地址,拋出異常 throw new customException($email); } } catch (customException $e) { //display custom message echo $e->errorMessage(); } ?>
#這個新的類別是舊的exception 類別的副本,外加errorMessage() 函數(shù)。正因為它是舊類別的副本,因此它從舊類別繼承了屬性和方法,我們可以使用 exception 類別的方法,例如 getLine()、getFile() 和 getMessage()。
getLine():?取得發(fā)生異常的程式碼在檔案中的行號
getFile():取得發(fā)生例外狀況的程式檔案名稱
getMessage():?取得例外訊息內(nèi)容
實(shí)例解釋:
上面的程式碼拋出了一個異常,並透過一個自訂的exception 類別來捕獲它:
1. ? customException() 類別是作為舊的exception類別的一個擴(kuò)充來創(chuàng)建的。這樣它就繼承了舊的 exception 類別的所有屬性和方法。
2. ? 建立 errorMessage() 函數(shù)。如果 e-mail 位址不合法,則函數(shù)傳回錯誤訊息。
3. ? 把 $email 變數(shù)設(shè)定為不合法的 e-mail 位址字串。
4. ? 執(zhí)行 "try" 程式碼區(qū)塊,由於 e-mail 位址不合法,因此拋出一個例外。
5. ? "catch" 程式碼區(qū)塊擷取異常,並顯示錯誤訊息。
多個異常
可以為一段腳本使用多個異常,來偵測多種情況。
可以使用多個 if..else 程式碼區(qū)塊,或一個 switch 程式碼區(qū)塊,或嵌套多個例外。這些異常能夠使用不同的exception 類,並傳回不同的錯誤訊息:
<?php header("Content-type:text/html;charset=utf-8"); class customException extends Exception { public function errorMessage() { // 錯誤信息 $errorMsg = '錯誤行號 '.$this->getLine().' in '.$this->getFile() .': <b>'.$this->getMessage().'</b> 不是一個合法的 E-Mail 地址'; return $errorMsg; } } $email = "someone@example.com"; try { // 檢測郵箱 if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE) { // 如果是個不合法的郵箱地址,拋出異常 throw new customException($email); } // 檢測 "example" 是否在郵箱地址中 if(strpos($email, "example") !== FALSE) { throw new Exception("$email 是 example 郵箱"); } } catch (customException $e) { echo $e->errorMessage(); } catch(Exception $e) { echo $e->getMessage(); } ?>
#實(shí)例解釋:
上面的程式碼測試了兩個條件,如果其中任何一個條件不成立,則拋出一個例外:
1. ? customException() 類別是作為舊的exception 類別的一個擴(kuò)充來創(chuàng)建的。這樣它就繼承了舊的 exception 類別的所有屬性和方法。
2. ? 建立 errorMessage() 函數(shù)。如果 e-mail 位址不合法,則函數(shù)傳回錯誤訊息。
3. ? 把 $email 變數(shù)設(shè)定為字串,字串是有效的 e-mail 位址,但包含字串 "example"。
4. ? 執(zhí)行 "try" 程式碼區(qū)塊,在第一個條件下,不會拋出例外。
5. ? 由於 e-mail 含有字串 "example",第二個條件會觸發(fā)例外。
6. ? "catch" 程式碼區(qū)塊會捕捉異常,並顯示適當(dāng)?shù)腻e誤訊息。
如果 customException 類別拋出了異常,但沒有捕獲 customException,僅捕獲了 base exception,則在那裡處理異常。
重新拋出例外
?有時,當(dāng)例外被拋出時,您也許希望以不同於標(biāo)準(zhǔn)的方式對它進(jìn)行處理??梢栽谝粋€ "catch" 程式碼區(qū)塊中再次拋出異常。
腳本應(yīng)該對使用者隱藏系統(tǒng)錯誤。對程式設(shè)計師來說,系統(tǒng)錯誤也許很重要,但是使用者對它們並不感興趣。為了讓使用者更容易使用,您可以再次拋出帶有對使用者比較友善的訊息的異
常:
<?php header("Content-type:text/html;charset=utf-8"); class customException extends Exception { public function errorMessage() { // 錯誤信息 $errorMsg = $this->getMessage().' 不是一個合法的 E-Mail 地址。'; return $errorMsg; } } $email = "someone@example.com"; try { try { // 檢測 "example" 是否在郵箱地址中 if(strpos($email, "example") !== FALSE) { // 如果是個不合法的郵箱地址,拋出異常 throw new Exception($email); } } catch(Exception $e) { // 重新拋出異常 throw new customException($email); } } catch (customException $e) { // 顯示自定義信息 echo $e->errorMessage(); } ?>
實(shí)例解釋:
上面的程式碼會偵測在郵件地址中是否含有字串 "example"。如果有,則再次拋出異常:
1. ? customException() 類別是作為舊的 exception 類別的一個擴(kuò)展來創(chuàng)建的。這樣它就繼承了舊的 exception 類別的所有屬性和方法。
2. ? 建立 errorMessage() 函數(shù)。如果 e-mail 位址不合法,則函數(shù)傳回錯誤訊息。
3. ? 把 $email 變數(shù)設(shè)定為字串,字串是有效的 e-mail 位址,但包含字串 "example"。
4. ? "try" 程式碼區(qū)塊包含另一個 "try" 程式碼區(qū)塊,這樣就可以再次拋出例外。
5. ? 由於 e-mail 包含字串 "example",因此觸發(fā)異常。
6. ? "catch" 程式碼區(qū)塊捕獲到該異常,並重新拋出 "customException"。
7. ? 捕獲到 "customException",並顯示一條錯誤訊息。
如果在目前的 "try" 程式碼區(qū)塊中異常沒有被捕獲,則它將在更高層級上尋找 catch 程式碼區(qū)塊。
設(shè)定頂層異常處理器
#set_exception_handler() 函數(shù)可設(shè)定處理所有未捕獲異常的使用者定義函數(shù)。
<?php header("Content-type:text/html;charset=utf-8"); function myException($exception) { echo "<b>Exception:</b> " , $exception->getMessage(); } set_exception_handler('myException'); throw new Exception('Uncaught Exception occurred'); ?>
以上程式碼的輸出如下:
Exception: Uncaught Exception occurred
在上面的程式碼中,不存在"catch" 程式碼區(qū)塊,而是觸發(fā)頂層的例外處理程序。應(yīng)該使用此函數(shù)來捕獲所有未被捕獲的異常。
異常的規(guī)則
· ? ?需要異常處理的程式碼應(yīng)該放入try 程式碼區(qū)塊內(nèi),以便擷取潛在的例外。
· ? ?每個 try 或 throw 程式碼區(qū)塊必須至少擁有一個對應(yīng)的 catch 程式碼區(qū)塊。
· ? ?使用多個 catch 程式碼區(qū)塊可以捕捉不同種類的例外。
· ? ?可以在 try 程式碼區(qū)塊內(nèi)的 catch 程式碼區(qū)塊中拋出(再次拋出)例外。
簡而言之:如果拋出了異常,就必須捕獲它。