1. 異常是什么
php 5 提供了一種新的面向?qū)ο蟮腻e誤處理方法。
異常處理用于在指定的錯誤(異常)情況發(fā)生時改變腳本的正常流程。這種情況稱為異常。
當(dāng)異常被觸發(fā)時,通常會發(fā)生:
- 當(dāng)前代碼狀態(tài)被保存
- 代碼執(zhí)行被切換到預(yù)定義(自定義)的異常處理器函數(shù)
- 根據(jù)情況,處理器也許會從保存的代碼狀態(tài)重新開始執(zhí)行代碼,終止腳本執(zhí)行,或從代碼中另外的位置繼續(xù)執(zhí)行腳本
我們將展示不同的錯誤處理方法:
- 異常的基本使用
- 創(chuàng)建自定義的異常處理器
- 多個異常
- 重新拋出異常
- 設(shè)置頂層異常處理器
注釋:異常應(yīng)該僅僅在錯誤情況下使用,而不應(yīng)該用于在一個指定的點跳轉(zhuǎn)到代碼的另一個位置。
2. 異常的基本使用
當(dāng)異常被拋出時,其后的代碼不會繼續(xù)執(zhí)行,php 會嘗試查找匹配的 "catch" 代碼塊。
如果異常沒有被捕獲,而且又沒用使用 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 /www/yapf/test/test.php:7 stack trace: #0 /www/yapf/test/test.php(13): checknum(2) #1 {main} thrown in /www/yapf/test/test.php on line 7
3. try、throw 和 catch
要避免上面范例中出現(xiàn)的錯誤,我們需要創(chuàng)建適當(dāng)?shù)拇a來處理異常。
適當(dāng)?shù)奶幚懋惓4a應(yīng)該包括:
讓我們觸發(fā)一個異常:
<?php // 創(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 必須對應(yīng)一個 catch" 的原則,可以設(shè)置一個頂層的異常處理器來處理漏掉的錯誤。
4. 創(chuàng)建一個自定義的 exception 類
創(chuàng)建自定義的異常處理程序非常簡單。我們簡單地創(chuàng)建了一個專門的類,當(dāng) php 中發(fā)生異常時,可調(diào)用其函數(shù)。該類必須是 exception 類的一個擴展。
這個自定義的 customexception 類繼承了 php 的 exception 類的所有屬性,您可向其添加自定義的函數(shù)。
我們開始創(chuàng)建 customexception 類:
<?php 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()。
范例解釋:
上面的代碼拋出了一個異常,并通過一個自定義的 exception 類來捕獲它:
5. 多個異常
可以為一段腳本使用多個異常,來檢測多種情況。
可以使用多個 if..else 代碼塊,或一個 switch 代碼塊,或者嵌套多個異常。這些異常能夠使用不同的 exception 類,并返回不同的錯誤消息:
<?php 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(); } ?>
范例解釋:
上面的代碼測試了兩種條件,如果其中任何一個條件不成立,則拋出一個異常:
如果 customexception 類拋出了異常,但沒有捕獲 customexception,僅僅捕獲了 base exception,則在那里處理異常。
6. 重新拋出異常
有時,當(dāng)異常被拋出時,您也許希望以不同于標(biāo)準(zhǔn)的方式對它進行處理。可以在一個 "catch" 代碼塊中再次拋出異常。
腳本應(yīng)該對用戶隱藏系統(tǒng)錯誤。對程序員來說,系統(tǒng)錯誤也許很重要,但是用戶對它們并不感興趣。為了讓用戶更容易使用,您可以再次拋出帶有對用戶比較友好的消息的異常:
<?php 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(); } ?>
范例解釋:
上面的代碼檢測在郵件地址中是否含有字符串 "example"。如果有,則再次拋出異常:
如果在當(dāng)前的 "try" 代碼塊中異常沒有被捕獲,則它將在更高層級上查找 catch 代碼塊。
7. 設(shè)置頂層異常處理器
set_exception_handler() 函數(shù)可設(shè)置處理所有未捕獲異常的用戶定義函數(shù)。
<?php function myexception($exception) { echo "<b>exception:</b> " , $exception->getmessage(); } set_exception_handler('myexception'); throw new exception('uncaught exception occurred'); ?>
以上代碼的輸出如下所示:
exception: uncaught exception occurred
在上面的代碼中,不存在 "catch" 代碼塊,而是觸發(fā)頂層的異常處理程序。應(yīng)該使用此函數(shù)來捕獲所有未被捕獲的異常。
8. 異常的規(guī)則
- 需要進行異常處理的代碼應(yīng)該放入 try 代碼塊內(nèi),以便捕獲潛在的異常。
- 每個 try 或 throw 代碼塊必須至少擁有一個對應(yīng)的 catch 代碼塊。
- 使用多個 catch 代碼塊可以捕獲不同種類的異常。
- 可以在 try 代碼塊內(nèi)的 catch 代碼塊中拋出(再次拋出)異常。
簡而言之:如果拋出了異常,就必須捕獲它。