PHP错误和异常处理

PHP 5 添加了类似于其它语言的异常处理模块。在 PHP 代码中所产生的异常可被 throw 语句抛出并被 catch 语句捕获。

需要进行异常处理的代码都必须放入 try 代码块内，以便捕获可能存在的异常。每一个 try 至少要有一个与之对应的 catch。

使用多个 catch 可以捕获不同的类所产生的异常。当 try 代码块不再抛出异常或者找不到 catch 能匹配所抛出的异常时，PHP 代码就会在跳转到最后一个 catch 的后面继续执行。当然，PHP 允许在 catch 代码块内再次抛出（throw）异常。 

Example:抛出并捕获一个异常

<?php
try{
	throw new Exception("catch a exception",42);
}catch(Exception $e){
	echo $e;
}
?>

　用户可以用自定义的异常处理类来扩展 PHP 内置的异常处理类。

PHP内置Exception类：（译者注：以下这段代码只为说明内置异常处理类的结构，它并不是一段有实际意义的可用代码。）

<?php
class Exception
{
    protected $message = 'Unknown exception';   // 异常信息
    protected $code = 0;                        // 用户自定义异常代码
    protected $file;                            // 发生异常的文件名
    protected $line;                            // 发生异常的代码行号

    function __construct($message = null, $code = 0);

    final function getMessage();                // 返回异常信息
    final function getCode();                   // 返回异常代码
    final function getFile();                   // 返回发生异常的文件名
    final function getLine();                   // 返回发生异常的代码行号
    final function getTrace();                  // backtrace() 数组
    final function getTraceAsString();          // 已格成化成字符串的 getTrace() 信息

    /* 可重载的方法 */
    function __toString();                       // 可输出的字符串
}
?>

　如果使用自定义的类来扩展内置异常处理类，并且要重新定义构造函数的话，建议同时调用 parent::__construct() 来检查所有的变量是否已被赋值。当对象要输出字符串的时候，可以重载 __toString() 并自定义输出的样式。 

Example #2 扩展 PHP 内置的异常处理类

<?php
 /**
 * 自定义一个异常处理类
 */
 class  MyException  extends  Exception
 {
     // 重定义构造器使 message 变为必须被指定的属性
     public function  __construct ( $message ,  $code  =  0 ) {
         // 自定义的代码

        // 确保所有变量都被正确赋值
         parent :: __construct ( $message ,  $code );
    }

     // 自定义字符串输出的样式
     public function  __toString () {
        return  __CLASS__  .  ": [ { $this -> code } ]:  { $this -> message } 
" ;
    }

    public function  customFunction () {
        echo  "A Custom function for this type of exception
" ;
    }
}


 /**
 * 创建一个用于测试异常处理机制的类
 */
 class  TestException
 {
    public  $var ;

    const  THROW_NONE     =  0 ;
    const  THROW_CUSTOM   =  1 ;
    const  THROW_DEFAULT  =  2 ;

    function  __construct ( $avalue  =  self :: THROW_NONE ) {

        switch ( $avalue ) {
            case  self :: THROW_CUSTOM :
                 // 抛出自定义异常
                 throw new  MyException ( '1 is an invalid parameter' ,  5 );
                break;

            case  self :: THROW_DEFAULT :
                 // 抛出默认的异常
                 throw new  Exception ( '2 isnt allowed as a parameter' ,  6 );
                break;

            default:
                 // 没有异常的情况下，创建一个对象
                 $this -> var  =  $avalue ;
                break;
        }
    }
}


 // 例子 1
 try {
     $o  = new  TestException ( TestException :: THROW_CUSTOM );
} catch ( MyException $e ) {       // 捕获异常
     echo  "Caught my exception
" ,  $e ;
     $e -> customFunction ();
} catch ( Exception $e ) {         // 被忽略
     echo  "Caught Default Exception
" ,  $e ;
}

 // 执行后续代码
 var_dump ( $o );
echo  "

" ;


 // 例子 2
 try {
     $o  = new  TestException ( TestException :: THROW_DEFAULT );
} catch ( MyException $e ) {       // 不能匹配异常的种类，被忽略
     echo  "Caught my exception
" ,  $e ;
     $e -> customFunction ();
} catch ( Exception $e ) {         // 捕获异常
     echo  "Caught Default Exception
" ,  $e ;
}

 // 执行后续代码
 var_dump ( $o );
echo  "

" ;


 // 例子 3
 try {
     $o  = new  TestException ( TestException :: THROW_CUSTOM );
} catch ( Exception $e ) {         // 捕获异常
     echo  "Default Exception caught
" ,  $e ;
}

 // 执行后续代码
 var_dump ( $o );
echo  "

" ;


 // 例子 4
 try {
     $o  = new  TestException ();
} catch ( Exception $e ) {         // 没有异常，被忽略
     echo  "Default Exception caught
" ,  $e ;
}

 // 执行后续代码
 var_dump ( $o );
echo  "

" ;
 ?>