在上一篇，我们介绍了PEAR的概念，编码规则，简单使用方法，你可能对它有了一个初步的了解。这次，我们将介绍现有的PEAR库中的一些模块的功能和它的使用。

一、命名约定
在了解现有的pear模块之前，我们先了解一下PEAR的组织分类方式和命名的约定。PEAR中的模块的组织方式和CPAN类似，每个模块的相关文件是放在自己的分类目录下面，有的则是直接放在pear的根目录下面（单个文件）。由于PEAR没有象java那样的名字空间，所以你的类名应该能够体现你的模块名或者父类名之间的关系，守一定的约定，比如，你的模块名："Mp3/common",那么，你的php文件应该位于：Mp3/common.php,你这个模块的类名应该是：Mp3_common。一般来说，如果你的模块是根据现有的某个模块改进而来的，那么建议把你的和现有的那个模块放在同一个目录下面。如果你设计的是一个新的类和模块，你可以自己建立一个新的目录，或者是按照相似的用途放在同样的目录下面。比如，你新编写了一个模块，用于处理日志的，建议你把它放在Log/下面，表示是用于Log处理的应用模块；如果新的模块是用于处理mp3的，那么你可以建立一个新的目录mp3,放在mp3目录下面。

二、现有的PEAR模块
由于Pear的大多数模块仍处于开发当中，因此，这里列举的是随着php4.05一起发布的pear中的模块，需要注意的是，一些抽象类或者是基类(如Mail.php,Log.php,Cache.php)没有列举出来，我们只是关注具有具体功能的模块。下面是这些模块的一个列表：

三、主要模块使用简介
现在我们将简单地介绍一些比较常用的，而且功能已经比较完善和稳定，可以用于“实战“模块，其中对于几个功能很强大的模块Db,phpdoc,XML_Parser，IT,ITX将在以后的文章中单独介绍。

1.PEAR/Installer
这个模块属于pear本身的核心模块，它完成pear其它模块的安装和维护工作，类似perl中的cpan模块的功能，不过目前只有install功能，其它诸如查询，检查依赖性等等都没有完成，pear本身也没有类似 cpan 那样的开放的站点，不过随着参与pear的开发人员的不断增加，一切都会有的。

使用语法：PEAR_Installer::installer($file)
$file是需要安装的模块文件，可以是本地文件，也可以是远程的文件，如http://或者是ftp，installer会自动下载到本地。文件一般使用gzip打包，其中要包括一个package.xml文件，用于描述你的这个模块的相关信息，如包含的文件，相互依赖性等，此外当然要包括你的模块的php文件。pacakage.xml的DTD文件在pear目录下面，名字是package.dtd.

<?php

require_once "PEAR/Installer.php";

$installer = new PEAR_Installer;

//安装指定的模块

$result = $installer->install($package_file);

if ( PEAR::isError($result)){

    echo "Install $package_file failed!";

}else {

    echo "Install $package_file sucess!";

}

?>

2.CMD
虽然大多数的php应用很少调用系统命令，因为这些应用都是基于web的，从运行效率和系统的负载考虑，都要避免直接调用系统命令，不过，在有些特殊的应用或者是你愿意把php作为一个shell工具的时候，调用现有的系统工具就是不可避免的了。CMD可以让你很方便地执行一系列的系统命令。

使用语法：setOption ($option, $setting)
设置参数$options为$setting

• $options是一个常量，它可以是以下值：
• CMD_SHUTDOWN : 通过shutdown函数来执行命令
• CMD_SHELL : 指定shell的路径
• CMD_OUTPUT : 是否屏蔽命令的标准输出
• CMD_NOHUP : 使用nohup后台执行命令
• CMD_VERBOSE : 将错误打印到标准输出

command($command)
添加需要执行的命令，$command可以是数组或普通的字符串

exec()
执行已经添加的命令

<?php

   require_once "CMD.php";

   $cmd = new CMD;

   $cmd->command('tar zcvf test.tar.gz ~/test');

   if ( $cmd->exec() ) {

       echo "success！\n";

   } esle {

       echo "Error:" . $cmd->lastError;

   }

?>

3.Benchmark/Timer和Benchmark/Iterate
这2个模块可以让你测试你的代码的运行效率如何，我认为这对于系统调试很有用：你可以尝试不同的算法，仔细考察每种算法需要运行的时间，然后选择最佳的方式。Benchmark/Timer测试运行中在2个不同的时间点的时间差，Benchmark/Iterate则是对Timer扩展，测试运行某段代码（函数）n次所需要的时间。

使用语法：Benchmark/Timer

<?php

     require_once "Benchmark/Timer.php";

     $timer = new Benchmark_Timer;



     $timer->start();

     $timer->setMarker('Marker 1');

     $timer->stop();



     $profiling = $timer->getProfiling();

?>

Benchmark/Iterate

Iterate::run()
循环运行指定的函数。这是一个具有可变参数的方法，第一个参数是要循环的次数，第2个参数是要执行的函数，第3个参数起则是要传递给测试函数的参数。

Iterate::get()
返回测试所用的时间

<?php

     require_once "Benchmark/Iterate.php";



     $benchmark = new Benchmark_Iterate;



     function foo($string)

     {

         print $string."


";

     }

     $benchmark->run(100, 'foo', 'test');

     $result = $benchmark->get();

?>

3.File/Find
&glob ($pattern, $dirpath, $pattern_type='php')
在$dirpath中搜索符合$pattern的目录和文件，返回匹配的文件和目录名数组

&search ($pattern, $directory, $type='php')
在$directory中搜索符合$pattern规则的文件，返回匹配的文件名数组（注意，只是文件，不包括子目录）。$pattern是要指定的搜索条件，一般是规则表达式，$patten_type指定使用什么模式的规则表达式，缺省是php模式，你也可以指定"perl"来使用perl模式的规则表达式

提示：search和glob不同的是，glob并不递归搜索子目录，而search则递归搜索子目录。

<?php

    require_once "File/Find.php";

    $find = new File_Find;

    //搜索当前目录

    $php_files = $find->glob("*php",".");

    if ( PEAR::isError( $php_files ) ){

        die "错误：" . $php_files->getMessage() ."\n" ;

    }

    //递归搜索当前目录

    $all_php_files = $find->search("*php",".");

    if ( PEAR::isError( $all_php_files ) ){

        die "错误：" . $php_files->getMessage() ."\n" ;

    }

?>

4.File/Passwd
操纵password格式的文件，类似如标准的unix password,apache 的.htppass,cvs的pserver password文件。从现有版本的代码来看，它还不能真正地用来维护这些passwd文件（比如并不支持shadow)。不过你可以用来创建类似的密码文件，当然，安全性不会很高。

• 使用方法：
• File_Passwd($file,$lock=0)----------创建对象，$file是你要操作的passwd文件，$lock指定是否要用flock对文件上锁。
• addUser($user,$pass,$cvsuser)----------增加一个用户,$user,$pass分别是用户名和密码，$cvsuser是cvs 用户的id
• modUser($user,$pass,$cvsuser)----------修改$user的密码为$pass,$cvsuser是cvs 用户的id
• delUser($user)----------删除指定的用户$user
• verifyPassword($user,$pass)----------检验用户密码
• close()----------保存刚才的修改到password文件，关闭password文件，对文件解锁。

5.File/SearchReplace
在文件中查找和替换字符串

使用方法：File_SearchReplace($find, $replace, $files, $directories = '', $include_subdir = 1, $ignore_lines = array())

生成并设置对象

$find
要查找的字符串，可以是字符串或规则表达式

$replace
要替换成的字符串，可以是字符串或规则表达式

$files
指定在哪些文件中进行替换操作，数组或者是以","分割的一个字符串

$directories
指定在那个目录中操作，可选，数组或者是以","分割的一个字符串

$include_subdir
如果是在目录中操作，指定是否在子目录中递归执行上述操作，可以是数值1或0。

$ignore_lines
指定要忽略的文件行，这是一个数组，任何以这个数组中任意一个字符串开始的文件行，都会忽略。

getNumOccurences()
返回已经执行了查找替换的次数

getLastError()
返回上一次的错误信息

setFind($find)
设置要查找的字符串

setReplace($replace)
设置要替换的字符串

setFiles($files)
设置要执行替换操作的文件

setDirectories($directories)
设置要替换操作的目录

setIncludeSubdir($include_subdir)
设置是否在子目录中也执行查找替换

setIgnoreLines($ignore_lines)
设置要忽略的行，只能在使用"normal"搜索函数的时候使用

setSearchFunction($search_function)
设置要使用的搜索函数，可以是下列参数：

• normal 缺省值，使用file函数读入文件内容，然后使用str_replace逐行的进行替换。
• quick 使用str_replace直接对整个文件进行替换
• preg 使用preg_replace()来进行替换,你可以使用符合这个函数要求的规则表达式
• ereg 使用ereg_replace()来进行替换,你可以使用符合这个函数要求的规则表达式

doSearch()
执行查找替换操作

<?php

    require_once "File/SearchReplace.php";

    require_once "File/Find";



    //递归搜索当前目录

    $find = new File_Find;

    $all_php_files = $find->search("*php",".");

    if ( PEAR::isError( $all_php_files ) ){

        die "错误：" . $php_files->getMessage() ."\n" ;

    }

    if ( !count($all_php_file) ){

        die "NO php source files found!\n";

    }

    //将<?的php标志修正成<?php,以符合pear标准

    $replace = new File_SearchReplace('<? ','<?php ',$all_php_files);

    $replace->doSearch();

    if ( $replace->getLastError() ) {

       die "发生错误:" . $replace->getLastError() ;

    } else {

       echo "共成功替换了 " . $replace->getNumOccurences() . " 处。\n";

    }

?>

6.HTML/Form
这个模块可以让你快速地生成一个提交的窗体，而无需重新去编写html代码

使用方法：Form::HTML_Form($action, $method = 'GET', $name = '', $target = '')

这个类的构造函数带有一些参数，这些参数和通常要编写html代码中的form参数是基本一致的，$action是在form中要提交到的URL,$name可以指定form的名字，$target指定是否要新开窗口等等。

下面的addXXX系列方法，用于在这个form中添加相应的控件，控件的属性和html中的也相一致。

[1] [2] 下一页