前者可以设置pear缺省的错误处理模式,后者是一个包装函数,返回一个pear_error的对象,和直接创建并返回pear_error的对象略有不同的是,如果省略$mode,$options等参数,它会使用缺省值来创建这个pear_error的对象,这些缺省值你可以使用 seterrorhandling()来定制。
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)捕获相应的错误。
- 实现你自己的功能。
phpdoc主页,可以从你的pear应用源码产生类似javadoc的api文档
php-mode for xemacs/emacs,为emacs/xemacs提供php的语法支持,能够很好支持pear代码风格
vim主页,非常优秀的一个编辑器,对php的支持也很好
| 作者简介 潘凡(night sailer):北京赛迪数据有限公司工程师。主要从事是数据的分析和转换,以及相关的开发工作。擅长使用vb,perl,php进行开发以及linux的中文化工作。近期兴趣是perl,php与xml的应用,php的mvc开发模式,perl-gtk的使用。您可以通过 e-mail:nightsailer@hotmail.com跟他联系。 |