使用方法：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"; //递归搜索当前目录 die "发生错误:" . $replace->getLastError() ; } else { echo "共成功替换了 " . $replace->getNumOccurences() . " 处。\n"; } ?> |
使用方法：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(); ?> |
使用方法：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"; } } ?> |
使用方法：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>"; } ?> |
使用方法：使用上这个模块和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>"; } ?> |
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,我们将在下篇详细讨论。
四、资源
PEAR CVS 你可以从这里获得最新的PEAR源码
Hoder 项目
PHPDoc 主页