PHP 5.0 例外処理メカニズムの詳細な調査

异常处理

   本文面向希望了解PHP5异常处理机制的程序员。阅读本文你需要具有一定面向对象编程和PHP基础。

　　PHP5内建的异常类需要有以下成员方法：

__construct()构造函数，需要一个出错信息和一个可选的整型错误标记作参数getMessage()取得出错信息 getCode()
出错的代码 getFile()异常发生的文件getLine()异常发生的行数 getTrace()跟踪异常每一步传递的路线，存入数组，返回该数组 getTraceAsString()和getTrace()功能一样，但可以将数组中的元素转成字符串并按一定格式输出
　　可以看出来，Exception 类的结构和Pear_Error 很相似。当你的脚本中遇到一个错误，你可以建立你的异常对象：

$ex = new Exception( "Could not open $this-＞file" );
　　Exception类的构造函数将接受一个出错信息和一个错误代码。

　　使用 throw关键字

　　建立一个Exception对象后你可以将对象返回，但不应该这样使用，更好的方法是用throw关键字来代替。throw用来抛出异常：

throw new Exception( "my message", 44 );
　　throw 将脚本的执行中止，并使相关的Exception对象对客户代码可用。

　　以下是改进过的getCommandObject() 方法：

　　index_php5.php

＜?php // PHP 5
require_once('cmd_php5/Command.php');
class CommandManager {
　private $cmdDir = "cmd_php5";

　function getCommandObject($cmd) {
　　$path = "{$this-＞cmdDir}/{$cmd}.php";
　　if (!file_exists($path)) {
　　　throw new Exception("Cannot find $path");
　　}
　require_once $path;
　if (!class_exists($cmd)) {
　　throw new Exception("class $cmd does not exist");
　}

　$class = new ReflectionClass($cmd);
　if (!$class-＞isSubclassOf(new ReflectionClass('Command'))) {
　　throw new Exception("$cmd is not a Command");
　}
　return new $cmd();
}
}
?＞
　　代码中我们使用了PHP5的反射(Reflection)API来判断所给的类是否是属于Command 类型。在错误的路径下执行本脚本将会报出这样的错误：

Fatal error: Uncaught exception 'Exception' with message 'Cannot find command/xrealcommand.php' in /home/xyz/BasicException.php:10
Stack trace:
#0 /home/xyz/BasicException.php(26):
CommandManager-＞getCommandObject('xrealcommand')
#1 {main}
thrown in /home/xyz/BasicException.php on line 10
　　默认地，抛出异常导致一个fatal error。这意味着使用异常的类内建有安全机制。而仅仅使用一个错误标记，不能拥有这样的功能。处理错误标记失败只会你的脚本使用错误的值来继续执行。

　　Try-catch 语句

　　为了进一步处理异常，我们需要使用try-catch语句—包括Try语句和至少一个的catch语句。任何调用 可能抛出异常的方法的代码都应该使用try语句。Catch语句用来处理可能抛出的异常。以下显示了我们处理getCommandObject()抛出的异常的方法：

　　index_php5.php 后半段

＜?php
// PHP 5
try {
　$mgr = new CommandManager();
　$cmd = $mgr-＞getCommandObject('realcommand');
　$cmd-＞execute();
} catch (Exception $e) {
　print $e-＞getMessage();
　exit();
}
?＞

　　可以看到，通过结合使用throw关键字和try-catch语句，我们可以避免错误标记“污染”类方法返回的值。因为“异常”本身就是一种与其它任何对象不同的PHP内建的类型，不会产生混淆。

　　如果抛出了一个异常，try语句中的脚本将会停止执行，然后马上转向执行catch语句中的脚本。

　　如果异常抛出了却没有被捕捉到，就会产生一个fatal error。

处理多个错误

　　在目前为止异常处理看起来和我们传统的作法—检验返回的错误标识或对象的值没有什么太大区别。让我们将CommandManager处理地更谨慎，并在构造函数中检查command目录是否存在。

　　index_php5_2.php

＜?php
// PHP 5
require_once('cmd_php5/Command.php');
class CommandManager {
private $cmdDir = "cmd_php5"

function __construct() {
if (!is_dir($this- ＞cmdDir)) {
throw new Exception("ディレクトリエラー: $this->cmdDir")
}
}

function getCommandObject($cmd) {
$path = "{$this->cmdDir}/{$ cmd}.php";
if (!file_exists($path)) {
throw new Exception("Cannot find $path");
}
require_once $path;
if (!class_exists($cmd)) {
throw new Exception("クラス $cmd が存在しません");
$class = new ReflectionClass($cmd)
if (!$class->isSubclassOf(new ReflectionClass('Command'))) {
throw new Exception("$cmd is not a Command");
}
return new $cmd();
}
}
?>

呼び出しによってプログラムエラーが発生する可能性がある場所は 2 つあります (__construct() と getCommandObject() ）））。それでも、クライアント コードを調整する必要はありません。 try ステートメントに多くのコンテンツを追加し、それを catch で均一に処理できます。 CommandManager オブジェクトのコンストラクターが例外をスローした場合、try ステートメントの実行は中止され、catch ステートメントが呼び出されて関連する例外をキャッチします。 getCommandObject() についても同じことが当てはまります。このようにして、2 つの潜在的なエラーの原因が同時に存在し、すべてのエラーを 1 つのステートメントで処理することができます。これにより、コードがよりきれいに見え、エラー処理要件が満たされます。前述した PHP の従来のエラー方式と比較すると、明らかに非常に有利です。

index_php5_2.phpの後半

注：index_php5.phpと比較すると、コードの前半には2つのエラーが考えられますが、このコードはindex_php5.phpの後半と全く同じです。



＜?php

// PHP 5

try {
$mgr = new CommandManager(); // 潜在的なエラー
$cmd = $mgr->getCommandObject('realcommand')
// 別の潜在的なエラー
$cmd->execute();
} catch (Exception $e) {
// ここでエラーを処理します
print $e->getMessage();
?>


あと一つ場所については言及しませんでした。さまざまなタイプのエラーをどのように区別すればよいでしょうか?たとえば、あるメソッドを使用してディレクトリが見つからないエラーを処理し、別のメソッドを使用して不正なコマンド クラスを処理することができます。

Exception クラスはオプションの整数のエラー識別子を受け入れることができます。これは、catch ステートメントでさまざまなエラーの種類を区別する方法です。

index_php5_3.php



＜?php
// PHP 5
require_once('cmd_php5/Command.php');

class CommandManager {

private $cmdDir = "cmd_php5"
const CMDMAN_GE NERAL_ERROR = 1; const CMDMAN_ILLEGALCLASS_ERROR = 2;

function __construct() {
if (!is_dir($this->cmdDir)) {
throw new Exception("ディレクトリ エラー: $this->cmdDir", self::CMDMAN_GENERAL_ERROR);
}

function getCommandObject($cmd) {
$path = "{$this->cmdDir}/{$cmd}.php";
if (!file_exists($path)) {
throw new Exception("Cannot find $path", self::CMDMAN_ILLEGALCLASS_ERROR);
}
require_once $path;
if (!class_exists($cmd)) {
throw new Exception("class $cmd が存在しません", self::CMDMAN_ILLEGALCLASS_ERROR);


$class = new ReflectionClass($cmd);
if (!$class->isSubclassOf(new ReflectionClass('Command'))) {
throw new Exception("$cmd はコマンドではありません", self::CMDMAN_ILLEGALCLASS_ERROR)
エラーの種類を定義し、さまざまな処理戦略を定義します。

index_php5_3.php



＜?php // PHP 5
try {
$mgr = new CommandManager()
$cmd = $mgr->getCommandObject('realcommand');
$cmd->execute( );

} catch (Exception $e) {

if ($e->getCode() == CommandManager::CMDMAN_GENERAL_ERROR) {
// 回復方法なし
die($e->getMessage()); else if ($e->getCode() == CommandManager::CMDMAN_ILLEGALCLASS_ERROR) {
error_log($e->getMessage());
print "attempting reversen"
// おそらくデフォルトのコマンドを呼び出そうとしているでしょうか？

}

?＞


この効果を達成するために別の方法を使用することもできます。つまり、最も基本的な Exception クラスからさまざまな種類の例外を表すサブクラスを派生し、それらをスローおよびキャッチします。





[1] [2] 次のページ