PHP 异常处理

异常（Exception）用于在指定的错误发生时改变脚本的正常流程。

当异常被触发时，通常会发生：

当前代码状态被保存
代码执行被切换到预定义的异常处理器函数
根据情况，处理器也许会从保存的代码状态重新开始执行代码，终止脚本执行，或从代码中另外的位置继续执行脚本

我们将展示不同的错误处理方法：

异常的基本使用
创建自定义的异常处理器
多个异常
重新抛出异常
设置顶层异常处理器


当异常被抛出时，其后的代码不会继续执行，PHP会尝试查找匹配的"catch"代码块。


如果异常没有被捕获，而且又没使用 set_exception_handler(0作相应的处理的话，那么将发生一个严重的错误(致命错误),并且输出"Uncaught_Exception"(未捕获异常)的错误消息。


<?php
//create function with an exception
function checkNum($number){
if($number>1){
throw new Exception("Value must be 1 or below");
}
return true;
}
//trigger exception
checkNum(2);
?>


上面的代码会获得类似这样的一个错误：
Fatal error: Uncaught exception 'Exception' 
with message 'Value must be 1 or below' in C:\webfolder\test.php:6 
Stack trace: #0 C:\webfolder\test.php(12): 
checkNum(28) #1 {main} thrown in C:\webfolder\test.php on line 6


Try,throw 和 catch
要避免上面例子出现的错误我们需要创建适当的代码来处理异常。


正确的处理程序应当包括：


1.Try-使用异常的函数应该位于"try"代码块内。如果没有触发异常，则代码将照常继续执行。但是如果异常触发，会抛出一个异常。
2.Throw-这里规定如何触发异常。每一个"throw"必须对应至少一个"catch"
3.Catch-"catch"代码块会捕获异常，并创建一个包含异常信息的对象


让我们触发一个异常：


<?php
//创建可抛出一个异常的函数
function checkNum($number){
if($number>1){
throw new Exception("Value must be 1 or below");
}
return true;
}
//在"try"代码块中触发异常


try{
checkNum(2);
//If the exeption is throw,this text will not be shown
echo 'If you see this, the number is 1 or below';
}
catch(Exception $e){
echo 'Message:'.$e->getMessage();
}
?>

创建一个自定义的Exception类

创建一个自定义的异常处理程序非常简单，我们简单创建一个专门的类，当PHP中发生异常时，可调用其函数。该类必须是exception类的一个扩展。
这个自定义的exception 类继承了PHP的exception类的所有属性，您可以向其添加自定义的函数。


<?php
class customException extends Exception{


public function errorMessage(){
//error message
$errorMsg = 'Error on line'.$this->getLine().'in'.$this->getFile()
.':<b>'.$this->getMessage().'</b> is not a valid E-Mail address';
return $errorMsg;
}
}


$email = "someone@exaple...com";


try{


//check if
if(filter_var($email, FILTER_VALIDATE_EMALL) === FALSE){


//throw exception if email is not valid
throw new customException($email);


}
}catch(customException $e){
//display custom message
echo $e->errorMessage();
}
?>

多个异常

可以为一段脚本使用多个异常，来检测多种情况。
可以使用多个if..else代码块，或一个switch代码块，或者嵌套多个异常。这些异常能够使用不同的exception类，并返回不同的错误消息"


<?php


class customException extends Exception{


public function errorMessage(){
//error message
$errorMsg = 'Error on line'.$this->getLine().'in'.$this->getFile().':<b>'.$this->getMessage().'</b> is not a valid E-Mail address';
return $errorMsg;
}


}


$email = "someone@exaple.com";


try{
//check if

if(filter_var($email, FILTER_VALIDATE_EMALL)===FALSE){
//throw exception if email is not valid
throw new customException($email);
}
//check for "example" in mail address
if(strpos($email,"example") !== FALSE){
throw new Exception("$email is an example e-mail");
}
}catch(customException $e){
echo $e->errorMessage();
}catch(Exception $e){
echo $e->getMessage();
}


?>

重新抛出异常

有时，当异常被抛出时，您也许希望以不同于标准的方式对它进行处理。可以在一个"catch"代码块中再次抛出异常。
脚本应该对用户隐藏系统错误。对程序员来说，系统错误也很重要，但是用户对它们并不感兴趣。为了让用户更容易使用，您
可以再次抛出带有对用户比较友好的消息异常：


<?php
class customException extends Exception{


public function errorMessage(){
//error message
$errorMsg = $this->getMessage().'is not a valid E-Mail address';
return $errorMsg;
}
}
$email = "someone@example.com";
try{
try{
//check for "example" in mail address
if(strpos($email,"example") !== FALSE){
//throw exeption if e-mail is not valid
throw new Exception($email);
}catch(customException $e){
//re-throw exception
throw new customException($email);
}catch(customException $e){
//display custom message
echo $e->errorMessage();
}
?>


设置顶层异常处理器
set_exception_handler()函数可设置处理所有未捕获异常的用户定义函数。


<?php
function myException($exception){
echo "<b>Exception:</b>".$exception->getMessage();
}
set_exception_handler("myException");
throw new Exception('Uncaught Exception occurred');
?>