PHP開發(fā)基礎教學之異常處理
一、異常是什麼？
異常用於在指定的錯誤發(fā)生時改變腳本的正常流程。
PHP 5 提供了一種新的物件導向的錯誤處理方法。
異常處理用於在指定的錯誤（異常）情況發(fā)生時改變腳本的正常流程。這種情況稱為異常。
當異常被觸發(fā)時，通常會發(fā)生：
?當前程式碼狀態(tài)被保存
?程式碼執(zhí)行被切換到預先定義（自訂）的異常處理器函數(shù)
?根據(jù)情況，處理器也許會從已儲存的程式碼狀態(tài)重新開始執(zhí)行程式碼，終止腳本執(zhí)行，或從程式碼中另外的位置繼續(xù)執(zhí)行腳本
我們將展示不同的錯誤處理方法：
?異常的基本使用
-
?建立自訂的例外處理器
?多個例外
?重新拋出例外
-
?設定頂層異常處理器
註解：異常應該只在錯誤情況下使用，而不應該用於在一個指定的點跳到程式碼的另一個位置。
#二、例外的基本使用
#當異常被拋出時，其後的程式碼不會繼續(xù)執(zhí)行，PHP 會嘗試尋找匹配的"catch" 程式碼區(qū)塊。
如果異常沒有被捕獲，而且沒有使用set_exception_handler() 作相應的處理的話，那麼將發(fā)生一個嚴重的錯誤（致命錯誤），並且輸出"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);
?>會得到類似這樣的輸出結果：
#三、Try、throw 和catch
要避免上面實例中出現(xiàn)的錯誤，我們需要建立適當?shù)某淌酱a來處理異常。
適當?shù)奶幚砝獬淌酱a應該包括：
Try - 使用例外的函數(shù)應該位於 "try" 程式碼區(qū)塊內。如果沒有觸發(fā)異常，則程式碼將照常繼續(xù)執(zhí)行。但是如果異常被觸發(fā)，會拋出一個異常。
?Throw - 裡規(guī)定如何觸發(fā)異常。每一個 "throw" 必須對應至少一個 "catch"。
?Catch - "catch" 程式碼區(qū)塊會擷取異常，並建立一個包含異常訊息的物件。
讓我們觸發(fā)一個例外：
程式碼如下
<?php
// 創(chuàng)建一個有異常處理的函數(shù)
function checkNum($number)
{
if($number>1)
{
throw new Exception("變量值必須小于等于 1");
}
return true;
}
// 在 try 塊 觸發(fā)異常
try
{
checkNum(2);
// 如果拋出異常，以下文本不會輸出
echo '如果輸出該內容，說明 $number 變量';
}
// 捕獲異常
catch(Exception $e)
{
echo 'Message: ' .$e->getMessage();
}
?>輸出如右圖所示
實例解釋：
上面的程式碼拋出了一個異常，並捕獲了它：
建立 checkNum() 函數(shù)。它檢測數(shù)字是否大於 1。如果是，則拋出一個異常。
?在 "try" 程式碼區(qū)塊中呼叫 checkNum() 函數(shù)。
checkNum() 函數(shù)中的例外被拋出。
?"catch" 程式碼區(qū)塊接收到該異常，並建立一個包含異常訊息的物件 ($e)。
透過從這個 exception 物件呼叫 $e->getMessage()，輸出來自該例外的錯誤訊息。
然而，為了遵循 "每個 throw 必須對應一個 catch" 的原則，可以設定一個頂層的異常處理器來處理漏掉的錯誤。
四、建立一個自訂的 Exception 類別
建立自訂的例外處理程序非常簡單。我們簡單地創(chuàng)建了一個專門的類，當 PHP 中發(fā)生異常時，可呼叫其函數(shù)。該類別必須是 exception 類別的一個擴充。
這個自訂的 exception 類別繼承了 PHP 的 exception 類別的所有屬性，您可以將自訂的函數(shù)新增至其。
我們開始建立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);
}
}
catch (customException $e)
{
//display custom message
echo $e->errorMessage();
}
?>輸出結果見右圖
這個新的類別是舊的exception 類的副本，外加errorMessage() 函數(shù)。正因為它是舊類別的副本，因此它從舊類別繼承了屬性和方法，我們可以使用 exception 類別的方法，例如 getLine()、getFile() 和 getMessage()。
實例解釋：
上面的程式碼拋出了一個異常，並透過一個自訂的exception 類別來捕獲它：
customException() 類別是作為舊的exception 類別的一個擴充來建立的。這樣它就繼承了舊的 exception 類別的所有屬性和方法。
建立 errorMessage() 函數(shù)。如果 e-mail 位址不合法，則函數(shù)傳回錯誤訊息。
?把 $email 變數(shù)設定為不合法的 e-mail 位址字串。
?執(zhí)行 "try" 程式碼區(qū)塊，由於 e-mail 位址不合法，因此拋出一個例外。
"catch" 程式碼區(qū)塊擷取異常，並顯示錯誤訊息
五、多個異常
可以為一段腳本使用多個異常，來偵測多種情況。
可以使用多個 if..else 程式碼區(qū)塊，或一個 switch 程式碼區(qū)塊，或嵌套多個例外。這些異常能夠使用不同的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() 類別是作為舊的 exception 類別的一個擴充功能來建立的。這樣它就繼承了舊的 exception 類別的所有屬性和方法。
建立 errorMessage() 函數(shù)。如果 e-mail 位址不合法，則函數(shù)傳回錯誤訊息。
?把 $email 變數(shù)設為一個字串，該字串是一個有效的 e-mail 位址，但包含字串 "example"。
執(zhí)行 "try" 程式碼區(qū)塊，在第一個條件下，不會拋出例外。
?由於 e-mail 含有字串 "example"，第二個條件會觸發(fā)例外。
"catch" 程式碼區(qū)塊會捕捉異常，並顯示適當?shù)腻e誤訊息。
如果 customException 類別拋出了異常，但沒有捕獲 customException，僅捕獲了 base exception，則在那裡處理異常。
六、重新拋出例外
#有時，當例外被拋出時，您也許希望以不同於標準的方式對它進行處理。可以在一個 "catch" 程式碼區(qū)塊中再次拋出異常。
腳本應該對使用者隱藏系統(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"。如果有，則再次拋出例外：
customException() 類別是作為舊的 exception 類別的擴充功能來建立的。這樣它就繼承了舊的 exception 類別的所有屬性和方法。
?建立 errorMessage() 函數(shù)。如果 e-mail 位址不合法，則函數(shù)傳回錯誤訊息。
把 $email 變數(shù)設定為字串，該字串是有效的 e-mail 位址，但包含字串 "example"。
?"try" 程式碼區(qū)塊包含另一個 "try" 程式碼區(qū)塊，這樣就可以再次拋出例外。
?由於 e-mail 包含字串 "example"，因此觸發(fā)例外。
?"catch" 程式碼區(qū)塊捕獲到該異常，並重新拋出 "customException"。
?捕獲到 "customException"，並顯示一條錯誤訊息。
如果在目前的 "try" 程式碼區(qū)塊中異常沒有被捕獲，則它將在更高層級上尋找 catch 程式碼區(qū)塊。
七、設定頂層例外處理器
#set_exception_handler() 函數(shù)可設定處理所有未捕獲例外狀況的使用者定義函數(shù)。
程式碼如下
<?php
function myException($exception)
{
echo "<b>Exception:</b> " , $exception->getMessage();
}
set_exception_handler('myException');
throw new Exception('Uncaught Exception occurred');
?>輸出見右圖
#在上面的程式碼中，不存在 "catch" 程式碼區(qū)塊，而是觸發(fā)頂層的例外處理程序。應該使用此函數(shù)來捕獲所有未被捕獲的異常。
八、異常的規(guī)則
#?需要異常處理的程式碼應該要放入try 程式碼區(qū)塊內，以便捕獲潛在的異常。
?每個 try 或 throw 程式碼區(qū)塊必須至少擁有一個對應的 catch 程式碼區(qū)塊。
使用多個 catch 程式碼區(qū)塊可以捕捉不同種類的例外。
可以在 try 程式碼區(qū)塊內的 catch 程式碼區(qū)塊中拋出（再次拋出）例外。
簡而言之：如果拋出了異常，就必須捕捉它。
?
