PHP 手册
后退 前进

章 20. 异常处理

目录
扩展 PHP 内置的异常处理类

PHP 5 添加了类似于其它语言的异常处理模块，可以在 PHP 内检测（try）、抛出（throw）和捕获（catch）异常。一个 try 至少要有一个与之对应的 catch。定义多个 catch 可以捕获不同的对象。PHP 会按这些 catch 被定义的顺序执行，直到完成最后一个为止。而在这些 catch 内，又可以抛出新的异常。

当一个异常被抛出时，其后（译者注：指抛出异常时所在的代码块）的代码将不会继续执行，而 PHP 就会尝试查找第一个能与之匹配的 catch。如果一个异常没有被捕获，而且又没用使用 set_exception_handler() 作相应的处理的话，那么 PHP 将会产生一个严重的错误，并且输出未能捕获异常的提示信息。

例子 20-1. 抛出一个异常

<?php
try {
     $error = 'Always throw this error' ;
     throw new Exception ( $error );

     // 从这里开始，tra 代码块内的代码将不会被执行
     echo 'Never executed' ;

} catch ( Exception $e ) {
    echo 'Caught exception: ' ,   $e -> getMessage (), "\n" ;
}

// 继续执行
echo 'Hello World' ;
?>

扩展 PHP 内置的异常处理类

用户可以用自定义的异常处理类来扩展 PHP 内置的异常处理类。以下的代码说明了在内置的异常处理类中，哪些属性和方法在子类中是可访问和可继承的。译者注：以下这段代码只为说明内置异常处理类的结构，它并不是一段有实际意义的可用代码。

例子 20-2. 内置的异常处理类

<?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() 并自定义输出的样式。

例子 20-3. 扩展 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 }\n " ;
    }

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


/**
* 创建一个用于测试异常处理机制的类
*/
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\n" , $e ;
     $e -> customFunction ();
} catch ( Exception $e ) {         // 被忽略
     echo "Caught Default Exception\n" , $e ;
}

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


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

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


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

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


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

// 执行后续代码
var_dump ( $o );
echo "\n\n" ;
?>
后退 起点 前进
Type Hinting 上一级 引用的解释