用PEAR来写你的下一个php程序[2]

[入库:2005年8月19日] [更新:2007年3月24日]

本文简介:选择自 tansf 的 blog

前者可以设置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的扩展应用,需要这么做:

    1. require_once "pear.php"
    2. 使用class your_pear_extend extends pear{}定义你的新类。
    3. 在你的类的构造函数中,调用父类pear的构造函数:
      
      function your_pear_extend{
      
          $this->pear();
      
          ...
      }
      
    4. 如果需要,定义你的析构函数 _your_pear_extend
    5. 如果需要,从pear_error派生出你自己的错误处理类
    6. 设置你的错误处理模式,并在适当的时候触发错误。
    7. 在执行可能产生错误的代码后,用pear::iserror($obj)捕获相应的错误。
    8. 实现你自己的功能。
    在最新的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的支持也很好

    作者简介
    潘凡(night sailer):北京赛迪数据有限公司工程师。主要从事是数据的分析和转换,以及相关的开发工作。擅长使用vb,perl,php进行开发以及linux的中文化工作。近期兴趣是perl,php与xml的应用,php的mvc开发模式,perl-gtk的使用。您可以通过 e-mail:nightsailer@hotmail.com跟他联系。

    本文关键:用PEAR来写你的下一个php程序
      相关方案
    Google
     

    本站最佳浏览方式为 分辨率 1024x768 IE 6.0(或更高版本的 IE浏览器)

    go top