PEAR: Commonly used modules_PHP tutorial-PHP Tutorial-php.cn

在上一篇，我们介绍了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)没有列举出来，我们只是关注具有具体功能的模块。下面是这些模块的一个列表：

Benchmark/Timer 测试你的一段php代码的运行效率
Benchmark/Benchmark_Iterate 测试你某个函数循环执行时的性能
Cache/Output 可以将你的php脚本的输出进行缓存，可以使用多种方式缓存（存在文件，数据库或者是共享内存中）,如果使用这个模块有可能增大服务器的负载，所以，如果你想通过动态脚本的缓存来提供效率，不妨使用Zend optimize,这个模块未必适合
Cache/Graphics 可以将你需要动态输出的图片进行缓存
Console/Getopt 命令行参数的处理模块
CMD 一个虚拟的shell，可以用它来运行一些系统的命令
Crypt/CBC 实现Perl Crypt::CBC 模块的仿真
Crypt/HCEMD5 实现Perl Crypt::HCE_MD5 模块的功能

Date/Calc 实现日期的相关操作
Date/Human Human历法的转换
DB 提供统一的、抽象的数据库操作层，后端支持多种数据库
File/Find 文件查找
File/Passwd 操纵password类的文件，如password,httppass,cvspassword
File/SearchReplace 在文件中查找替换字符串
HTML/Form 可以在html中快速地创建form
HTML/IT 实现模板定制，动态生成页面的功能，类似phplib中的模板功能，但是要简单易用
HTML/ITX 实现对IT的扩展功能，可以更加灵活地定制你的模板，实现更复杂的操作
HTML/Processor XML_Parser的扩展，使之可以应用于html文件的操作
HTTP/Compress 用于Php 输出缓冲机制的一个包装类，同时可以对缓冲的内容进行压缩存储
Image/Remote 无需把整个图片都下载到本地就可以获取远端系统的图片的信息，
Log/composite Horde对log抽象类做的一个扩展，可以使多个日志处理对象能够获得同一个日志事件。注意，Log目录下面的模块都是Horde项目的一部分，大部分都是抽象的超类
Log/file 将日志信息写入文件
Log/mcal 将信息发送到本地或远端的日程管理软件-mcal的数据库中
Log/observer Horder中Observer的一个超类
Log/sql 将日志信息发送到sql数据库中
Log/syslog 将信息发送到syslog中
Mail/RFC822 检查一个email地址是否是合法的rf822 email地址
Mail/sendmail 使用sendmail来发送信件
Mail/smtp 使用smtp服务器来发送信件
Math/Fraction 处理分形的数学计算
Math/Util 计算最大公约数
NET/Curl 对php的Curl扩展所作的面向对象的包装
NET/Dig 操纵dig，进行dns相关的查询操作
NET/SMTP 使用NET/Socket实现SMTP协议
NET/Socket 通用的Socket类，实现了常用的socket操作的包装
Numbers/Roman 阿拉伯数字和罗马数字的相互转换
Payment/Verisign 实现和Verisign支付网关的交互
Pear 提供Pear模块的2个基本类，PEAR 和PEARError类
PEAR/Installer pear的安装类，提供Perl中的CPAN模块类似的功能
PHPDoc 从php代码中自动生成API文档
Schedule/at 和Unix 上的AT守护进程进行交互
XML/Parser 基于php的xml扩展所作的xml的解析器
XML/Render 将xml文档生成其它的格式（html,pdf),这只是一个抽象类，在最新的pear cvs代码中已经有了html的实现
XML/RPC 用php实现xml-rpc的一个抽象类，在最新的pear cvs代码中已经有了xml/RPC/Server的实现

三、主要模块使用简介
现在我们将简单地介绍一些比较常用的，而且功能已经比较完善和稳定，可以用于“实战“模块，其中对于几个功能很强大的模块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.

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()
执行已经添加的命令

require_once "CMD.php";
$cmd = new CMD;
$cmd->command(tar zcvf test.tar.gz ~/test);
if ( $cmd->exec() ) {
echo "success! ";
} esle {
echo "Error:" . $cmd->lastError;
}
?>

3. Benchmark/Timer and Benchmark/Iterate
These two modules allow you to test how efficiently your code runs. I think this is very useful for system debugging: you can try different algorithms and carefully examine each Each algorithm takes time to run and then chooses the best one. Benchmark/Timer tests the time difference between two different time points during operation. Benchmark/Iterate is an extension of Timer to test the time required to run a certain piece of code (function) n times.

Using syntax: Benchmark/Timer

Timer::setMarker($name) Set the current time point to $name
Timer::start() Start testing
Timer::stop() Stop testing
Timer::timeElapsed($start = Start, $end = Stop) Calculate the time difference between $start and $end
Timer::getProfiling() returns the time elapsed between start and stop
require_once "Benchmark/Timer.php";
$timer = new Benchmark_Timer;

$timer->start();
$timer->setMarker(Marker 1);
$timer->stop();

$profiling = $timer->getProfiling();
?>

Benchmark/Iterate

Iterate::run()
Run the specified function in a loop. This is a method with variable parameters. The first parameter is the number of times to loop, the second parameter is the function to be executed, and the third parameter onwards are the parameters to be passed to the test function.

Iterate::get()
Returns the time taken by the test

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)
Search for directories and files matching $pattern in $dirpath and return an array of matching file and directory names

&search ($pattern, $directory, $type=php)
Search for files that match the $pattern rules in $directory and return an array of matching file names (note, only files, not subdirectories). $pattern is the search condition to be specified, usually a regular expression. $patten_type specifies what mode of regular expression to use. The default is php mode. You can also specify "perl" to use the perl mode regular expression

Tip: The difference between search and glob is that glob does not search subdirectories recursively, while search searches subdirectories recursively.

require_once "File/Find.php";
$find = new File_Find;
//Search the current directory
$php_files = $find->glob(" *php",".");
if ( PEAR::isError( $php_files ) ){
die "Error: " . $php_files->getMessage() ." " ;
}
/