了2个函数: setErrorHandling($mode, $options = null) raiseError($message = null, $code = null, $mode = null,$options = null, $userinfo = null)
前者可以设置PEAR缺省的错误处理模式,后者是一个包装函数,返回一个PEAR_Error的对象,和直接创建并返回PEAR_Error的对象略有不同的是,如果省略$mode,$options等参数,它会使用缺省值来创建这个PEAR_Error的对象,这些缺省值你可以使用setErrorHandling()来定制。
PEAR_Error PEAR_Error是PEAR的错误对象的一个基类,和PEAR不同,一般来说,你可以直接创建PEAR_Error的实例,创建方式: $error = new PEAR_Error($message, $code, $mode, $options, $userinfo);
$message是你的错误信息,$code是该错误的错误号,后3个参数是紧密联系的: $mode:是这个错误的处理模式,可以下列常量: PEAR_ERROR_RETURN:仅仅返回该错误对象(缺省方式) PEAR_ERROR_PRINT:在构建函数中打印这个错误信息,但是当前程序会继续运行。 PEAR_ERROR_TRIGGER:使用PHP的trigger_error() 触发一个错误,如果你已经设置了错误处理函数,或者你把PHP的错误处理级别设置为E_USER_ERROR,那么当前程序将会被终止。 PEAR_ERROR_DIE:打印错误并退出,程序终止。 PEAR_ERROR_CALLBACK:使用一个回调函数或者方法来处理当前错误,程序终止。 $options:这个参数只有在$mode是PEAR_ERROR_TRIGGER和PEAR_ERROR_CALLBACK的时候才起作用,如果是PEAR_ERROR_TRIGGER,$options必须是E_USER_NOTICE, E_USER_WARNING 或 E_USER_ERROR这3个常量的一个,同PHP中trigger_error的值一致。如果$mode是PEAR_ERROR_CALLBACK,$options可以是一个字符串,内容是要回调的函数名,也可以是一个2元素的数组,分别是一个对象变量,和一个字符串(标明要调用的方法)。 $userinfo:存放附加的用户信息,你可以把相关的调试信息放在这里。
PEAR_Error中有一些常用的方法,这些方法在PHP文挡没有描述,这里一一列出:
int getMode:返回当前的错误处理模式,整型。 string getMessage:返回当前完整的错误信息,字符串。 mixed getCallback:返回当前的回调信息,可能是所回调的函数名,或者是(对象,方法)的数组。 int getCode:返回整型的错误代码。 string getType:返回错误的类型,也就是当前的类名,字符串。 string getUserInfo:返回附加的用户信息,字符串。 string getDebugInfo:内容同上。 string toString:返回当前对象的详细字符串描述,内容包括错误处理的模式,级别,错误信息,错误代码,相关回调函数等等。
总结
至此,对于PEAR的介绍就结束了。概括地说,如果你要做一个PEAR的扩展应用,需要这么做:
require_once "PEAR.php" 使用class your_pear_extend extends PEAR{}定义你的新类。 在你的类的构造函数中,调用父类PEAR的构造函数:function your_pear_extend{ $this->PEAR(); ... }
如果需要,定义你的析构函数 _your_pear_extend 如果需要,从PEAR_Error派生出你自己的错误处理类 设置你的错误处理模式,并在适当的时候触发错误。 在执行可能产生错误的代码后,用PEAR::isError($obj)捕获相应的错误。 实现你自己的功能。 在最新的PHP4.05的PEAR核心发布里,已经有不少优秀的应用模块了,比如:PHPDoc,Cache,HTML...当然,相对于CPAN来说,PEAR只是刚刚起步,需要PHP社区的人们的共同努力,来完善它,增强它,PHP才会越来越强大。
参考资料
Pear主页
PHP主页
PHPDoc主页,可以从你的PEAR应用源码产生类似JAVADOC的API文档
PHP-Mode for XEmacs/Emacs,为emacs/xemacs提供php的语法支持,能够很好支持pear代码风格
Vim主页,非常优秀的一个编辑器,对php的支持也很好
关于作者
|