PHP教程之PEAR:经常使用模块

在学习中，我也一直这样要求着自己。   在上一篇，咱们引见了PEAR的概念，编码划定规矩，复杂利用办法，你能够对它有了一个初步的懂得。此次，咱们将引见现有的PEAR库中的一些模块的功效和它的利用。
1、定名商定
在懂得现有的pear模块之前，咱们先懂得一下PEAR的组织分类体例和定名的商定。PEAR中的模块的组织体例和CPAN相似，每一个模块的相干文件是放在本人的分类目次上面，有的则是直接放在pear的根目次上面（单个文件）。因为PEAR没有象java那样的名字空间，所以你的类名应当可以表现你的模块名或父类名之间的关系，守必定的商定，好比，你的模块名："Mp3/common",那末，你的php文件应当位于：Mp3/common.php,你这个模块的类名应当是：Mp3_common。普通来讲，假如你的模块是依据现有的某个模块改善而来的，那末建议把你的和现有的谁人模块放在统一个目次上面。假如你设计的是一个新的类和模块，你可以本人创立一个新的目次，或是依照类似的用处放在一样的目次上面。好比，你新编写了一个模块，用于处置日记的，建议你把它放在Log/上面，暗示是用于Log处置的使用模块；假如新的模块是用于处置mp3的，那末你可以创立一个新的目次mp3,放在mp3目次上面。

2、现有的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/SearchWordStr 在文件中查找交换字符串
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的完成

3、次要模块利用简介
如今咱们将复杂地引见一些对照经常使用的，并且功效已对照完美和不乱，可以用于“实战“模块，个中关于几个功效很壮大的模块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

Timer::setMarker($name) 设置以后工夫点为$name
Timer::start() 入手下手测试
Timer::stop() 中断测试
Timer::timeElapsed($start = 'Start', $end = 'Stop') 盘算$start和$end 这2个工夫点的工夫差
Timer::getProfiling() 前往start 和 stop 之间所耗用的工夫
<?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/SearchWordStr
在文件中查找和交换字符串

利用办法：File_SearchWordStr($find, $replace, $files, $directories = '', $include_subdir = 1, $ignore_lines = array())

生成并设置对象

$find
要查找的字符串，可所以字符串或划定规矩表达式

$replace
要交换成的字符串，可所以字符串或划定规矩表达式

$files
指定在哪些文件中停止交换操作，数组或是以","朋分的一个字符串

$directories
指定在谁人目次中操作，可选，数组或是以","朋分的一个字符串

$include_subdir
假如是在目次中操作，指定是不是在子目次中递归履行上述操作，可所以数值1或0。

$ignore_lines
指定要疏忽的文件行，这是一个数组，任何故这个数组中恣意一个字符串入手下手的文件行，城市疏忽。

getNumOccurences()
前往已履行了查找交换的次数

getLastError()
前往上一次的毛病信息

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

setWordStr($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/SearchWordStr.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_SearchWordStr('<? ','<?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中的也相分歧。
addText($name, $title, $default, $size = HTML_FORM_TEXT_SIZE)
addCheckbox($name, $title, $default)
addTextarea($name, $title, $default,$width = HTML_FORM_TEXTAREA_WT,$height = HTML_FORM_TEXTAREA_HT)
addPassword($name, $title, $default, $size = HTML_FORM_PASSWD_SIZE)
addSubmit($name = "submit", $title = "Submit Changes")
addReset($title = "Discard Changes")
addSelect($name, $title, $entries, $default = '', $size = 1,$blank = '', $multiple = false, $attribs = '')
addRadio($name, $title, $value, $default)
addImage($name, $src)
addHidden($name, $value)

Display()
显示这个窗体

<?php
require_once "HTML/Form.php";
//创立并显示登录窗体
$myform = new HTML_Form("./login.php");
$myform->addText('username','用户名','');
$myform->addPasswd('passwd','登录暗码',20);
$myform->addHidden('retry','1');
$myform->addSumit('login','登录');
$myform->Display();
?>





7.Mail/RFC822
反省一个输出的email是不是正当，不是一件很轻松的工作，你或许测验考试利用一些划定规矩表达式来反省，然而并不是那末便利无效。如今，假如要反省一系列的邮件地址是不是合适RFC822尺度，并把它们拆分红独自的email地址，你可以尝尝这个模块，十分复杂适用。

利用办法：Mail_RFC822($address = null, $default_domain = null, $nest_groups = null, $validate = null)

类机关函数，$address是你要验证的一系列的地址，$default_domain，指定缺省的域名或主机名，$nest_groups 是不是在输入了局中停止分组，以便显示$validate 是不是需求验证每一个原子parseAddressList($address = null, $default_domain = null, $nest_groups = null, $validate = null)剖析验证所给定的地址列表，假如地址无效，前往拆分后的独自的地址列表，假如产生毛病，则前往毛病信息。

<?php
require_once "Mail/RFC822.php";
$rf822 = new Mail_RFC822;
$result=$rf822->paseAddressList('who;whoim@hotmail.com;test@test.ch');
if ( $rf822->error ){
echo "Error:$result";
}else {
reset($result);
for ($i=0; $i< count($result);$i++){
echo "email:$result[$i]\n";
}
}
?>





8.Mail/Sendmail
sendmail是unix/linux下面最经常使用的MTA,这个模块可让你直接利用sendmail来发送函件

利用办法：Mail_sendmail($params)

类机关函数，$params是一个联系关系数组,你可以设定sendmail的参数，今朝只要'sendmail_path'是无效的，用来设置sendmail的途径 send($recipients, $headers, $body) 发送函件，$recipients是你的收件人的email地址，可所以单个，也能够是用;离隔的地址列表，只需合适RFC82尺度就能够。$headers是你发送函件的信头，这是一个联系关系数租，数组的关头字是信头的名字（如Subject)，数组值则是信头的值(好比：Hello!)。处置后的信头将会是：Subject:Hello! $body 是函件的信体，包含一切的MIME编码后的局部。假如胜利，前往真，不然前往一个PEAR_Error对象

<?php
require_once "Mail/sendmail.php";
$sendmail = new Mail_sendmail(array('sendmail_path=>'/usr/local/bin/sendmail'));
$header = array('Subject'=>'Hello','BCC'=>'test2@hotmail.com');
$body = 'This is a test message from nightsailer.com';
$result = $sendmail->send('test@nightsailer.com', $header, $body);
if ( PEAR::isError($result) ){
echo "<h1> 发送掉败 </h1><br>缘由：".$result->getMessage()."<br>";
}else {
echo "<h1>祝贺！发送胜利！</h1><br>";
}
?>





9.Mail/smtp
关于如今有些站点不答应利用sendmail,那末假如你的php法式但愿利用发信功效，就需求可以经由过程利用内部的smtp办事器来完成响应的功效了。

利用办法：利用上这个模块和Mail::sendmail根基上是一样的。需求注重的是：这个模块需求利用Net::SMTP模块：Mail_smtp($params)
$params的无效参数是：
'host' smtp的办事器地址，缺省是 localhost
'port' smtp办事端口，缺省是25
'auth' smtp是不是需求受权验证，缺省是false
'usename' smtp受权的用户名
'password' smtp受权的暗码

send($recipients, $headers, $body)
发送

<?php
require_once "Mail/sendmail.php";
$params=array('host'=>'smtp.nightsailer.com','auth'=true,
'username'=>'night','password'=>'123456');
$sendmail = new Mail_sendmail($params);
$header = array('Subject'=>'Hello','BCC'=>'test2@hotmail.com');
$body = 'This is a test message from nightsailer.com';
$result = $sendmail->send('test@nightsailer.com', $header, $body);
if ( PEAR::isError($result) ){
echo "<h1> 发送掉败 </h1><br>缘由：".$result->getMessage()."<br>";
}else {
echo "<h1>祝贺！发送胜利！</h1><br>";
}
?>





10.Schedule/At
这个模块供应了unix下面的at法式的接口

add($cmd, $timespec, $queue = false, $mail = false )
追加一个at号令

这个办法将为at法式生成一个定制的功课:
$cmd 是你要运转的法式或剧本
$timespec 是功课入手下手履行的工夫，格局与at请求的不异
$queue 可选参数，指明功课的队列名
$mail 可选参数，指明是不是在功课停止后要发送email报告请示运转了局

show($queue = false)
显示在at队列中的号令，前往一个联系关系数组，数组的key是功课的编号，响应的键值也是一个联系关系数组，内容是array（runtime，queue）$queue是一个可选参数，你可以用它限制只前往队列中队列名婚配$queue的功课列表

remove($job = false)
从at队列中删除指定的at功课$job是要删除的功课编号,假如，胜利，前往true,不然前往false

<?php
require_once "Schedule/At.php";
$at = new Schedule_At();
//生成并追加一个功课
$result = $at->add ('find / -type file -name core -exec rm -f {} \;','00:00');
if ( PEAR::is_Error($result) ) {
echo "没法追加功课！\n";
echo "缘由：$result->getMessage() \n";
exit;
}
//显示以后at队列
$queue = $at->show();
if ( PEAR::isError($queue) ) {
echo "产生毛病！\n";
echo "缘由：" . queue->getMessage(). "\n";
exit;
}
reset( $queue );
while ( list($job, $cmd) = each $queue ){
echo "[$job]" . $cmd['runtime'] . "-" .$cmd['queue']；
echo "\n"
}
?>





以上是一些PEAR模块的利用，更加具体的申明需求你本人去观察这些模块的源文件，或你可使用phpdoc主动生成这些模块的api文档。关于phpdoc,咱们将鄙人篇具体会商。

4、资本
PEAR CVS 你可以从这里取得最新的PEAR源码
Hoder 项目
PHPDoc 主页

  另外要叮嘱各位的是，抵御诱惑，ASP/PHP/JSP/.NET的对比也许会让你无所适从，你也许学了一半PHP，又开始打C#的主意，或者有人说JAVA很强，这个时候的你绝对不能动摇，哪怕你真想学。

基础有没有对学习php没有太大区别，关键是兴趣。

因为blog这样的可以让你接触更多要学的知识，可以接触用到类，模板，js ，ajax

如果你可以写完像留言板这样的程序，那么你可以去一些别人的代码了，

首推的搜索引擎当然是Google大神，其次我比较喜欢 百度知道。不过搜出来的结果往往都是 大家copy来copy去的，运气的的概率很大。

对于懒惰的朋友，我推荐php的集成环境xampp或者是wamp。这两个软件安装方便，使用简单。但是我还是强烈建议自己动手搭建开发环境。

先学习php和mysql,还有css(html语言很简单)我认为现在的效果比以前的方法好。

使用 jquery 等js框架的时候，要随时注意浏览器的更新情况，不然很容易发生框架不能使用。

如果你已经到这种程度了，那么你已经可以做我的老师了。其实php也分很多的区域，

当留言板完成的时候，下步可以把做1个单人的blog程序，做为目标，

至于模板嘛，各位高人一直以来就是争论不休，我一只小菜鸟就不加入战团啦，咱们新手还是多学点东西的好。

当然这种网站的会员费就几十块钱。

当然这种网站的会员费就几十块钱。

当留言板完成的时候，下步可以把做1个单人的blog程序，做为目标，

这些都是最基本最常用功能，我们这些菜鸟在系统学习后，可以先对这些功能深入研究。

当留言板完成的时候，下步可以把做1个单人的blog程序，做为目标，

有时候汉字的空格也能导致页面出错，所以在写代码的时候，要输入空格最好用引文模式。

,熟悉html,能用div+css，还有javascript，优先考虑linux。我在开始学习的时候，就想把这些知识一起学习，我天真的认为同时学习能够互相呼应，因为知识是相通的。

说点我烦的低级错误吧，曾经有次插入mysql的时间 弄了300年结果老报错，其实mysql的时间是有限制的，大概是到203X年  具体的记不清啦，囧。