PEAR の概要: PEAR を使用して次の PHP プログラムを作成する

PEAR の概要: PEAR を使用して次の php プログラムを作成します

?あなたはすでに PHP のベテランで、素晴らしいコードをたくさん書いているかもしれません。しかし、今それらを現在のプロジェクトに追加したい場合、それは少し難しいでしょうか?友人はあなたのコードをプロジェクトのモジュールとして使用したいと考えていますが、あなたはまったく異なるコーディング スタイルを使用していることに気づきました。友人に適応させるか、書き直すこともできます。

?

私に従って、PEAR 標準を使用して PHP プログラムを作成してください。あなたのプログラムとコードは、PERL の CPAN と同様に、他の専門家のコードと簡単に統合されます。より高いエネルギーを生成します。

?

PEAR とは

PEAR は、PHP Extension and Application Repository の略称です。簡単に言うと、PEAR は PHP の CPAN です。

?

なぜ PEAR を使用するのですか?

PHP は、簡潔で効率的な非常に優れたスクリプト言語です。4.0 のリリースにより、PHP は最高のインターネット開発言語の 1 つになったと言えます。 , PHP は、特に中小規模の商用アプリケーションを迅速かつ効率的に開発できる必要がある Web サイト開発者にとって推奨される言語です。しかし、PHP アプリケーションの数が増え続けるにつれて、これらのアプリケーションに対する統一された標準と効果的な管理が不足しているため、PHP コミュニティが PERL コミュニティの人々と同じように相互にコードやアプリケーションを簡単に共有することが困難になっています。なぜなら、PHP には CPAN と同じ標準がないからです。アプリケーション コード モジュールを分類および管理するための統一されたコード ベース (PERL に詳しい人なら、CPAN が巨大な PERL 拡張モジュール ウェアハウスであることを知っています。作成されたアプリケーション モジュールは、次の適切な分類ディレクトリに配置できます)。 CPAN や他の人は非常に簡単に再利用できます。もちろん、アプリケーション モジュールを作成するときはガイドラインに従う必要もあります)

。

?

このため、PEAR が誕生し、4.04 以降の PHP コアとともに配布されています。

?

PEAR は私にどのようなメリットをもたらしますか?

1. 前述したように、PEAR は特定のカテゴリに従って PEAR アプリケーション コード ライブラリを管理し、他の人が結果を簡単に取得して共有できます。

?

2.PEAR は単なるコード リポジトリではなく、標準でもあります。この標準を使用して PHP コードを記述すると、プログラムの可読性と再利用性が向上し、エラーの可能性が減ります。

?

3.PEAR は、デストラクターやエラー キャッチなどの関数を実装するための 2 つのクラスを提供することで、フレームワークを構築します。これらの関数は継承を通じて使用できます。

?

PEAR エンコード ルール

PEAR のコーディング ルールには、インデント ルール、制御構造、関数呼び出し、関数定義、コメント、インクルード コード、PHP タグ、ファイル ヘッダーのコメント ブロック、CVS タグ、URL サンプル、定数の命名が含まれます。簡単な紹介は次のとおりです:

• インデントのルール:

  PEAR ではコードをインデントするために 4 つのスペースが必要ですが、TAB は使用されません。 VIM を使用する場合は、次の設定を ~/.vimrc に追加します:

  set expandtab
  set shiftwidth=4
  set tabstop=4

  ?

  Emacs/XEmacs を使用している場合は、indent-tabs-mode を nil に設定する必要があります。

  しかし、私のように (X)Emacs を使用して PHP ファイルを編集したい場合は、PHP-MODE をインストールすることを強くお勧めします。これにより、PEAR コードを作成するときに、PHP のインデント スタイルが自動的に調整されます。 -MODE 優れた機能が多数あり、リソースリストから最新版のPHP-MODEをダウンロードできます。

• 制御構造:

  ここで言及する制御構造には、if while スイッチなどが含まれます。コントロール構造の場合は、関数呼び出しと混同されないように、キーワード (if for .. など) の後にスペースを入れ、その後にコントロールの括弧を置く必要があります。また、中括弧 {} を使用するようにしてください。たとえそれが構文的にオプションであっても、可能な限り完全に。これにより、将来新しいコード行を追加する必要がある場合に論理的な混乱やエラーが発生するのを防ぐことができます。以下に例を示します:

  if ((条件1) && (条件2)) {
      语句1；
  }esleif ((条件3) || (条件4)) {
      语句2；
  }else {
      语句3；
  }

  ?

• 関数呼び出し:

  関数呼び出しの場合、関数名と左括弧 (() の間にスペースがあってはなりません。関数パラメーターの場合、区切りのカンマと次のパラメーターの間に同じスペースがあり、スペースがあってはなりません最後のパラメータと右括弧の間のスペースは次のとおりです。

  $result = foo($param1, $param2, $param3);
  不规范的写法：
  $result=foo ($param1,$param2,$param3);
  $result=foo( $param1,$param2, $param3 );

  ?

  さらに、関数の戻り結果を代入する場合は、等号と代入する変数の間にスペースを入れる必要があります。同時に、関連する代入ステートメントが連続している場合は、適切な代入ステートメントを追加します。次のようにスペースを配置します:

  $result1 = $foo($param1, $param2, $param3);
  $var2    = $foo($param3);
  $var3    = $foo($param4, $param5);

  ?

• 関数の定義:

  関数定義は「1 つの真中括弧」規則に従います。

  function connect(&$dsn, $persistent = false)
  {
      if (is_array($dsn)) {
          $dsninfo = &&dsn;
      } else {
          $dsninfo = DB::parseDSN($dsn);
      }
      if (!$dsninfo || !$dsninfo['phptype']) {
          return $this->raiseError();
      }
      return true;
  }

  ?

  上に示したように、オプションのパラメーターはパラメーター リストの最後に置く必要があり、常に意味のある関数値を返そうとします。

• 关于注释：

  对于类的在线文档，应该能够被PHPDoc转换，就象JavaDoc那样。PHPDoc也是一个PEAR的应用程序，更详细的介绍你可以去 http://www.phpdoc.de/ 查看。除了类的在线文档，建议你应该使用非文档性质的注释来诠释你的代码，当你看到一段代码时想：哦，我想不需要在文档里去仔细描述它吧。那么你最好给这 段代码作一个简单的注释，这样防止你会忘记它们是如何工作的。对于注释的形式，C的 /* */和C++的//都不错，不过，不要使用Perl或者shell的#注释方式。

• 包含代码：

  无论什么时候，当你需要无条件包含进一个class文件，你必须使用requre_once;当你需要条件包含进一个class文件，你必须使用 include_once;这样可以保证你要包含的文件只会包含一次，并且这2个语句共用同一个文件列表，所以你无须担心二者会混淆，一旦 require_once 包含了一个文件，include_once不会再重复包含相同的文件，反之亦然。

• PHP代码标记：

  任何时候都要使用bb9bd6d87db7f8730c53cb084e6b4d2d定义你的php代码，而不要简单地使用b26da186e11666e6dd99f28d6205715c,这样可以保证PEAR的兼容性，也利于跨平台的移植。

• 文件头的注释声明：

  所有需要包含在PEAR核心发布的PHP代码文件，在文件开始的时候，你必须加入以下的注释声明：

  /* vim: set expandtab tabstop=4 shiftwidth=4: */
  // +----------------------------------+
  // | PHP version 4.0                                                      |
  // +----------------------------------+
  // | Copyright (c) 1997, 1998, 1999, 2000, 2001 The PHP Group             |
  // +----------------------------------+
  // | This source file is subject to version 2.0 of the PHP license,       |
  // | that is bundled with this package in the file LICENSE, and is        |
  // | available at through the world-wide-web at                           |
  // | http://www.php.net/license/2_02.txt.                                 |
  // | If you did not receive a copy of the PHP license and are unable to   |
  // | obtain it through the world-wide-web, please send a note to          |
  // | license@php.net so we can mail you a copy immediately.               |
  // +----------------------------------+
  // | Authors: Original Author                         |
  // |          Your Name                                  |
  // +----------------------------------+
  //
  // $Id$

  ?

  对于不在PEAR核心代码库中的文件，建议你也在文件的开始处有这样一个类似的注释块，标明版权，协议，作者等等。同时也在第一行加入VIM的MODELINE，这样在VIM中能够保持PEAR的代码风格。

• CVS标记：

  如上面所展示那样，在每个文件中加入CVS的ID标记，如果你编辑或修改的文件中没有这个标记，那么请加入，或者是替换原文件中相类似的表现形式（如"Last modified"等等）

• URL样本：

  你可以参照RFC 2606,使用"www.example.com"作为所有的URL样本。

• 常量命名：

  常量应该尽量使用大写，为了便于理解，使用下划线分割每个单词。同时，你应该常量所在的包名或者是类名作为前缀。比如，对于Bug类中常量应该以 Bug_开始。以上是PEAR的编码规则，详细的编码规则可以参考PEAR中的CODING_STANDDARD文件的说明。为了更好地理解这些编码规 则，你也可以参考一下现有PEAR核心模块的代码。

开始使用ＰＥＡＲ

• PEAR

  使用PEAR很简单，你只需这样定义你自己的PEAR程序：

  require_once "PEAR.php";
  class your_class_name extends PEAR{
  	你的类定义...
  }

  ?

  当然，你需要遵守前面说的PEAR的编码规则，之后你就可以在你的类内部实现你要做的事情了。下面，我们展开讨论一下， 实际上PEAR为我们提供了2个预定义类： PEAR:这是PEAR的基类，所有的PEAR扩展都要从它继承派生出来。 PEAR_Error：PEAR的错误处理的基类，你可以选择派生出自己的错误处理的类。

  一般来说，你不应该直接创建PEAR的实例，而是要自己派生出一个新的类，然后再创建这个新类的实例。作为基类，PEAR给我们提供了一些有用的功能，最主要的就是析构函数和错误处理

  1. 析构函数

     PHP支持构造函数，但是并不支持析构函数，不过，PHP提供register_shutdown_function()这个函数，从而能够在脚本 终止前回调注册的函数，因此PEAR利用这个特性，提供了析构函数的仿真。假如你有一个PEAR的子类，叫做mypear,那么在mypear类中，你可 以定义一个函数，函数名是下划线加上你的类名，_mypear(),这个函数就是这个类的析构函数。不过这个析构函数和C++中的析构函数不太一样，它不 会在对象被删除的时候执行，而是在脚本结束的时候，毕竟这只是一个仿真。由于是使用了register_shutdown_function()，所以在 你的析构函数里，打印的信息将不会返回浏览器中。此外，在你的构造函数中，需要调用一下它的父类的构造函数，因为PHP不会自动调用父类的构造函数，而析 构函数需要在PEAR的构造函数中注册，我们可以看看PEAR的源代码：

     function PEAR() {
     if (method_exists($this, "_".get_class($this))) {
         global $_PEAR_destructor_object_list;
         $_PEAR_destructor_object_list[] = &this;
     }
     if ($this->_debug) {
         printf("PEAR constructor called, class=%s\n",
                get_class($this));
     }    
     .....
     function _PEAR_call_destructors() {
         global $_PEAR_destructor_object_list;
         if (is_array($_PEAR_destructor_object_list) && 
               sizeof($_PEAR_destructor_object_list)) {
         reset($_PEAR_destructor_object_list);
         while (list($k, $objref) = each($_PEAR_destructor_object_list)) {
             $destructor = "_".get_class($objref);
             if (method_exists($objref, $destructor)) {
             $objref->$destructor();
             }
         }
         //清空已注册的对象列表，
         //防止重复调用
         $_PEAR_destructor_object_list = array();
         }
     }
     ....	
     register_shutdown_function("_PEAR_call_destructors");
     

     ?

     上面这段代码展示了PEAR是如何实现析构函数的,在构件函数中，将检查当前类中是否有析构函 数，如果有，那么将把当前类的引用放入一个全局列表中，在_PEAR_call_destructors中，则检查这个全局列表中的每个元素是否存在相应 的析构函数，如果有，则调用它，最后将全局列表清空。

     在PEAR.php的最后一行代码，则调用 register_shutdown_function("_PEAR_call_destructors")，注册 _PEAR_call_destructors，这样，当脚本执行完毕的时候，PHP会回调这个函数。使用析构函数，你可以在处理完用户的请求，退出之前 做一些必要的"善后"工作，典型的例子是，你可以关闭打开的文件，断开数据库的连接，将某些数据存入磁盘等等。

  2. 错误处理

     PEAR中可以让你有很多的方式来处理错误，你不仅仅是简单地返回一个错误代码，或者错误的信息，而是可以返回一个PEAR_Error对象，或者是由PEAR_Error派生出来的新的错误对象。

     PEAR 中的错误对象的并没有限定具体的输出形式，它可以仅仅是捕获错误，不给用户返回太多的信息，也可以是去回调一个特殊错误处理函数，同时，即使输出错误信 息，它也强迫你必须要是HTML形式，你可以输出XML，CSV形式，或者是其他你自己定义的形式，你只需要从PEAR_Error派生一个新的类，然后 在适当的时候创建并"抛出"这个新类的对象就可以了。

• 简单的错误处理：

  在PEAR中，最简单的错误处理是"抛出"这个错误，你只要简单地创建并返回一个PEAR_Error的对象就可以了。下面是一个简单的例子：

  function myconnect($host = "localhost", $port = 1080)
  {
      $fp = fsockopen($host, $port, $errno, $errstr);
      if (!is_resource($fp)) {
          return new PEAR_Error($errstr, $errno);
      }
      return $fp;
  }
  $sock = myconnect();
  if (PEAR::isError($sock)) {
      print "connect error: ".$sock->getMessage()."<BR>\n"
  }
  

  ?

  如上面代码所展示的，在执行一段可能产生错误的代码后，你需要使用PEAR的isError来检测是否存在错误，并且可以使用PEAR_Error的getMessage来取得最近一次的错误信息。注意：一定要在关键的地方使用使用PEAR::isError

• 使用raiseError

  #PHP4.0.5以后，PEAR多了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的扩展应用，需要这么做：

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的支持也很好

?

来源：http://www.ibm.com/developerworks/cn/linux/sdk/php/pear1/

?