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 } \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" ;
?>