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