BlaBla.cn

PHP: 异常处理 - Manual

BlaBla.cn
引用的解释 > <Name resolution rules
Last updated: Wed, 19 Mar 2008

异常处理

PHP 5 添加了类似于其它语言的异常处理模块。在 PHP 代码中所产生的异常可被 throw 语句抛出并被 catch 语句捕获。需要进行异常处理的代码都必须放入 try 代码块内,以便捕获可能存在的异常。每一个 try 至少要有一个与之对应的 catch。使用多个 catch 可以捕获不同的类所产生的异常。当 try 代码块不再抛出异常或者找不到 catch 能匹配所抛出的异常时,PHP 代码就会在跳转到最后一个 catch 的后面继续执行。当然,PHP 允许在 catch 代码块内再次抛出( throw)异常。

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

Example#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 内置的异常处理类。以下的代码说明了在内置的异常处理类中,哪些属性和方法在子类中是可访问和可继承的。译者注:以下这段代码只为说明内置异常处理类的结构,它并不是一段有实际意义的可用代码。

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

Example#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" ;
?>


引用的解释 > <Name resolution rules
Last updated: Wed, 19 Mar 2008
 

 
BlaBla.cn

© 2005-2008 BlaBla.cn 版权所有