首頁 >php教程 >php手册 >PEAR:常用模块

PEAR:常用模块

WBOY
WBOY原創
2016-06-13 10:35:461259瀏覽

在上一篇,我们介绍了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和Benchmark/Iterate
这2个模块可以让你测试你的代码的运行效率如何,我认为这对于系统调试很有用:你可以尝试不同的算法,仔细考察每种算法需要运行的时间,然后选择最佳的方式。Benchmark/Timer测试运行中在2个不同的时间点的时间差,Benchmark/Iterate则是对Timer扩展,测试运行某段代码(函数)n次所需要的时间。

使用语法:Benchmark/Timer

Timer::setMarker($name) 设置当前时间点为$name
Timer::start() 开始测试
Timer::stop() 停止测试
Timer::timeElapsed($start = Start, $end = Stop) 计算$start和$end 这2个时间点的时间差
Timer::getProfiling() 返回start 和 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()
循环运行指定的函数。这是一个具有可变参数的方法,第一个参数是要循环的次数,第2个参数是要执行的函数,第3个参数起则是要传递给测试函数的参数。

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

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则递归搜索子目录。

require_once "File/Find.php";
$find = new File_Find;
//搜索当前目录
$php_files = $find->glob("*php",".");
if ( PEAR::isError( $php_files ) ){
die "错误:" . $php_files->getMessage() ." " ;
}
/

陳述:
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn