?你可能已经是个PHP的老手了，写了很多非常棒的代码。但是，如果你现在要把它们加入到你现在的项目中去，是否有些吃力？你的朋友想使用你的代码作为他的项目中的一个模块，但是你发现你们使用了截然不同的编码风格，让他适应，甚至不如重写一个！

?

请跟我来，使用PEAR标准编写你的PHP程序吧，你的程序将会拥有更大的活力，你的程序和代码将会很方便地和其他高手的代码融合在一起，PEAR就象CPAN对于PERL一样，会让PHP产生更高的能量。

?

什么是ＰＥＡＲ

ＰＥＡＲ是ＰＨＰ扩展与应用库（the PHP Extension and Application Repository）的缩写。它是一个ＰＨＰ扩展及应用的一个代码仓库，简单地说，ＰＥＡＲ就是ＰＨＰ的ＣＰＡＮ。

?

为什么要使用ＰＥＡＲ？

PHP是一个非常优秀的脚本语言，简洁、高效，随着4.0的发布，越来越多的人使用它来进 行动态网站的开发，可以说，PHP已经成为最优秀的INTERNET开发语言之一，尤其对于那些需要能够快速、高效地开发中小规模的商业应用的网站开发人 员，PHP是其首选的语言。但是随着PHP的应用的不断增多，对于这些应用缺乏统一的标准和有效的管理，因此，PHP社区很难象PERL社区的人们那样方 便的共享彼此的代码和应用，因为PHP缺乏象CPAN那样的统一的代码库来分类管理应用的代码模块（熟悉PERL的人都知道，CPAN是一个巨大的 PERL的扩展模块仓库，编写的应用模块可以放在CPAN下面的适当的分类目录下面，其他的人可以很方便地复用，当然，你编写应用模块时候也需要遵守其中 的准则。）

?

为此，PEAR就应运而生了，并且从4.04开始，随着PHP核心一起被分发。

?

ＰＥＡＲ能给我带来什么好处？

1.如前所述，PEAR按照一定的分类来管理PEAR应用代码库，你的PEAR代码可以组织到其中适当的目录中，其他的人可以方便地检索并分享到你的成果。

?

2.PEAR不仅仅是一个代码仓库，它同时也是一个标准，使用这个标准来书写你的PHP代码，将会增强你的程序的可读性，复用性，减少出错的几率。

?

3.PEAR通过提供2个类为你搭建了一个框架，实现了诸如析构函数，错误捕获功能，你通过继承就可以使用这些功能。

?

ＰＥＡＲ的编码规则

PEAR的编码规则包括缩进规则，控制结构，函数调用，函数定义，注释，包含代码，PHP标记，文件头的注释块，CVS标记，URL样例，常量的命名这11方面。下面简要地介绍一下：

• 缩进规则：

  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 for while switch 等。对于控制结构，在关键字（如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);

  ?

• 函数定义：

  函数定义遵循"one true brace"习俗：

  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代码标记：

  任何时候都要使用<?php ?>定义你的php代码，而不要简单地使用<? ?>,这样可以保证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 licen