分类归档: PHP

PHP中的日期处理

by Allan Kent
我正打算用PHP编写一种帮助处理系统。我发现我必须知道处理完最后一位客户的问题后已经过去了多长时间?当我过去用ASP时解决这个问题相当简单,ASP有相应的函数DateDiff可以给出两个日期间间隔多少月、多少天和多少秒。当我搜寻完PHP手册后我发现PHP并没有类似的函数。

本文包含以下内容:
1、 得到目前的日期和时间-我们有多少种方式?
2、 改变日期显示的方式-日期和时间的显示形式
3、 转换现在的日期为Unix的时间戳值
4、 改变日期
a. 增加时间
b. 减去时间
c. 找出两日期之间的间隔
5、 为PHP添加DateAdd函数
6、 为PHP添加DateDiff函数

**得到目前的日期和时间

在Unix中,时间的表示方式为计算从1970年1月1日零时起所过去的秒数,这称为UNIX 时间戳(Unix Epoch)。
如果我们有这样一段的代码:
?
echo time();
?
将返回值958905820
而此时的时间为2000年5月21日12时43分。
你也许会说这相当不错。当这对我毫无帮助,或者只有一点帮助。在PHP中,对日期处理的函数都必须用到由time()返回的时间戳值。同时,由于PHP在Unix和Windows系统中均使用同样的时间戳值,这就允许你不需要修改代码即可在不同的系统间移植。另外的一个好处是time()函数返回的是一个整数,你可以将其作为整数字段或文本字段存入数据库,而不必使用特别的日期/时间字段。
你已经基本了解了Unix的时间戳值,现在让我们来展示它的实际用途。

改变日期显示的方式-日期和时间的显示形式

PHP提供两个办法来将Unix的时间戳值转换成为有用的数据。第一个是date()函数。这个函数有两个参数-第一个字符串用于设定你所希望返回的格式,第二个为Unix的时间戳值。
格式化字符串通过一些简单的特殊格式化字符来显示你所希望看到的格式的日期和时间。假设你希望日期以这样的格式显示“18h01 Sunday 21 May”。
我们需要对字符串中的每一部分使用一个特殊格式化字符,你可以从PHP手册中日期和时间函数库中找到。这样的特殊格式化字符数量不少,他们所表示的类似于星期几、月的英文名、用2位或4位数表示的年份,是否是上午(AM)或下午(PM)以及其他。对于这个例子我们需要的特殊字符为:
‘H’ -24 小时制的小时
‘i’- 分钟
‘l’- 星期几的英文全名
‘d’- 本月的第几日
‘F’- 月份的英文全名
因此我们的格式化字符串为”Hhi l d F”, PHP代码为:
?
echo date (“Hhi l d F” ,time());
?
当我们执行这段代码,我们发现我们所得到的结果为:
180609 Sunday 21 May
这样的结果看起来有些奇怪。让我们再查一下PHP手册,原来’h’所代表的是12 小时制的小时数。这再次证明了一句真理:“计算机只做你所告诉它该做的,而不是你想要它做的”。我们有两个选择。第一个是在h前使用转义字符“”:
echo date (“Hhi l d F”, time());
我们得到这样的结果:
18h12 Sunday 21 May
这正是我们所要的。但如果我们在一个十分复杂的句子中需要包含日期和时间,我们是否需要对每个字符使用转义字符?
答案当然是不。我们使用另一个函数strftime()。
strftime()有两个好处。第一个好处我们并不在本文讨论范围内-如果你使用setlocale()函数,你可以通过strftime得到相应语言的月份的名称。另外的一个好处是你可以将特别的日期和时间的格式化字符包含在你的字符串中。这同时也意味着无论你是否要学习date()函数的所有特殊格式化字符,你都必须学习一整套完全不同的格式化字符。
strftime()工作的方式和date()没有什么不同,除了特殊格式化字符的前面必须添加一个百分号%。如果用strftime()函数,前面例子的代码如下:
?
echo strftime (“%Hh%M %A %d %b” ,time());
?
结果为:
18h24 Sunday 21 May
这也许看起来将简化繁,但考虑一下如果你所需要的显示的为”Today is Sunday 21 May 2000. The time is somewhere close to 18h24.” 我想使用date()函数无疑令人感到厌烦。
在开始的时候,我提及我们有两种方式可以从Unix时间戳值中得到有用的数据。我们刚刚了解了date()和strftime()。另一个getdate()。这个函数只需要Unix 的时间戳值作为参数,而函数的返回值为日期和时间的数组。
下面是一个例子:
?
$date_time_array = getdate (time());
echo $date_time_array[ “weekday”];
?
返回的结果为:
Sunday
除了”weekday”,该数组的其他部分为:
“seconds” –秒
“minutes” –分
“hours” –小时
“mday” – 本月的第几天
“wday” -本周的第几天(数字)
“mon” -月(数字)
“year” –年
“yday” – r本年的第几天(数字)
“month” -月份全名
我们现在可以得到容易辨认的日期和时间。那么其他呢?

**转换现在的日期为Unix的时间戳值

通常你必须处理一些日期或时间格式的数据。打开M$的一个Access数据库,所有的日期都以YYYY/MM/DD的格式存储,加入目前的日前即为2000/05/27。Mktime()函数可以将一个时间转换成Unix的时间戳值。
函数的格式为:int mktime(int hour, int minute, int second, int month, int day, int year, int [is_dst] );
从左往右你必须提供小时、分、秒、月、天和年。最后一个参数用于指定你是否处于夏令时,此参数是可选的,所以我们将忽略它。
代码如下:
?
echo mktime (0, 0,0 ,5, 27,2000 );
?
由于不知道小时、分和秒同时这些参数必须填写,我将其设置为0。设置为0意味着时间为午夜。
?
$access_date = “2000/05/27”;
//explode()函数用一个字符串作为分界来分解另一个字符串。这个例子$access_date通过字符串”/”来分解
$date_elements = explode(“/” ,$access_date);
// 此时
// $date_elements[0] = 2000
// $date_elements[1] = 5
// $date_elements[2] = 27
echo mktime (0, 0,0 ,$date_elements [1], $date_elements[ 2],$date_elements [0]);
?
我们看一个比从Access数据库单纯获得日期更复杂的情况,我们得到一个以下格式的日期和时间:2000/05/27 02:40:21 PM
?
// 来自Access的字符串
$date_time_string = “2000/05/27 02:40:21 PM”;
// 将字符串分解成3部分-日期、时间和上午/下午
$dt_elements = explode(” ” ,$date_time_string);
// 分解日期
$date_elements = explode(“/” ,$dt_elements[ 0]);
// 分解时间
$time_elements = explode(“:” ,$dt_elements[ 1]);
// 如果是下午,我们将时间增加12小时以便得到24小时制的时间
if ($dt_elements [2]== “PM”) { $time_elements[ 0]+=12;}
// 输出结果
echo mktime ($time_elements [0], $time_elements[ 1], $time_elements[ 2], $date_elements[1], $date_elements[2], $date_elements[0]);
?

**修改日期

有时我们需要知道6小时以后是什么时间,35天前的日期或者从你最后一次玩Quake3后已过去多少秒。我们已经知道如何用mktime()函数从单独的日期和时间中获得Unix的时间戳值。如果我们需要的并非目前日期和时间的Unix时间戳值,我们该咋办?下面是一些练习可以帮助说明我们后面所要做的。
正如前面所见,mktime()使用以下参数:小时、分、秒、月、天和年。想想第二节,getdate()函数可以为我们获得这些参数。
?
// 将目前的时间戳值放入一数组内
$timestamp = time();
echo $timestamp;
echo “p”;
$date_time_array = getdate( $timestamp);
// 用mktime()函数重新产生Unix时间戳值
$timestamp = mktime($date_time_array [“hours”], $date_time_array[“minutes” ],$date_time_array[ “seconds”],$date_time_array [“mon”], $date_time_array[“mday” ],$date_time_array[ “year”]);
echo $timestamp;
?
看起来有一些令人感到迷惑。我将用一些变量来使上面的程序看起来更容易了解。
?
// 将目前的时间戳值放入一数组内
$timestamp = time();
echo $timestamp;
echo “p”;
$date_time_array = getdate( $timestamp);
$hours = $date_time_array[ “hours”];
$minutes = $date_time_array[“minutes”];
$seconds = $date_time_array[ “seconds”];
$month = $date_time_array[“mon”];
$day = $date_time_array[“mday”];
$year = $date_time_array[“year”];
// 用mktime()函数重新产生Unix时间戳值
$timestamp = mktime($hours ,$minutes, $seconds,$month ,$day,$year);
echo $timestamp;
?
现在我们将由getdate()所产生的时间戳值放入相对应的名称变量中,所以代码变得相对容易阅读和理解。现在如果我们需要在目前的时间上加上19个小时,我们用$hours+19代替mktime()函数中的$hours。mktime()将自动为我们将时间转到第二天。
?
// 将目前的时间戳值放入一数组内
$timestamp = time();
echo strftime( “%Hh%M %A %d %b”,$timestamp);
echo “p”;
$date_time_array = getdate($timestamp);
$hours = $date_time_array[“hours”];
$minutes = $date_time_array[“minutes”];
$seconds = $date_time_array[“seconds”];
$month = $date_time_array[“mon”];
$day = $date_time_array[“mday”];
$year = $date_time_array[“year”];
// 用mktime()函数重新产生Unix时间戳值
// 增加19小时
$timestamp = mktime($hours + 19, $minutes,$seconds ,$month, $day,$year);
echo strftime( “%Hh%M %A %d %b”,$timestamp);
echo “br~E after adding 19 hours”;
?
运行后得到:
14h58 Saturday 03 Jun
09h58 Sunday 04 Jun
~E after adding 19 hours
减少时间也是同样的-你只需要减少相应变量的值即可。
得到两个不同时间值的差同样也是非常简单。你所需要做的只是将两个时间值转换为Unix的时间戳值,然后两者相减即可。两者之差即为两个时间所相隔的秒数。另外一些算法可以很快地将秒转为天、小时、分和秒。

**为PHP添加DateAdd函数

正如在文章一开始我所说的-写本文的原因是因为我在PHP中找不到类似ASP的DateDiff函数。在介绍完PHP是如何处理日期和时间,让我们将ASP中常用的两个函数移植到PHP。第一个函数是DateAdd。
根据Vbscript的文档,DateAdd(interval,number,date)函数的定义为“返回已添加指定时间间隔的日期。”
Inetrval为表示要添加的时间间隔字符串表达式,例如分或天;number为表示要添加的时间间隔的个数的数值表达式;Date表示日期。
Interval(时间间隔字符串表达式)可以是以下任意值:
yyyy year年
q Quarter季度
m Month月
y Day of year一年的数
d Day天
w Weekday一周的天数
ww Week of year周
h Hour小时
n Minute分
s Second秒
w、y和d的作用是完全一样的,即在目前的日期上加一天,q加3个月,ww加7天。
?
function DateAdd ($interval, $number, $date) {
$date_time_array = getdate($date);
$hours = $date_time_array[“hours”];
$minutes = $date_time_array[“minutes”];
$seconds = $date_time_array[“seconds”];
$month = $date_time_array[“mon”];
$day = $date_time_array[“mday”];
$year = $date_time_array[“year”];
switch ($interval) {
case “yyyy”: $year +=$number; break;
case “q”: $month +=($number*3); break;
case “m”: $month +=$number; break;
case “y”:
case “d”:
case “w”: $day+=$number; break;
case “ww”: $day+=($number*7); break;
case “h”: $hours+=$number; break;
case “n”: $minutes+=$number; break;
case “s”: $seconds+=$number; break;
}
$timestamp = mktime($hours ,$minutes, $seconds,$month ,$day, $year);
return $timestamp;}
?
我们可以将上面的代码保存为dateadd.inc文件,然后运行以下代码:
?
include(‘dateadd.inc’);
$temptime = time();
echo strftime( “%Hh%M %A %d %b”,$temptime);
$temptime = DateAdd(“n” ,50,$temptime);
echo “p”;
echo strftime( “%Hh%M %A %d %b”,$temptime);
?
我们将得到:
15h41 Saturday 03 Jun
16h31 Saturday 03 Jun
为PHP添加DateDiff函数
现在DateAdd已经完成,那么DateDiff呢?
根据文档,DateDiff(interval,date1,date2)函数的定义为“返回两个日期之间的时间间隔”。
Intervals参数的用法与DateAdd函数中的相同。出于避免过于复杂的考虑,我们决定忽略Vbscript中DateDiff函数中其它复杂的参数,即其两个可选的参数变量[firstdayofweek[, firstweekofyear]](它们用于决定星期中第一天是星期天还是星期一和一年中第一周的常数。而且我们只允许intervals有以下五个值:”w”(周)、”d”(天)、”h”(小时)、”n”(分钟) 和”s”(秒)。

Let’s see what we can come up with: 下面的代码是我们所需要的:
?
Function DateDiff ($interval, $date1,$date2) {
// 得到两日期之间间隔的秒数
$timedifference = $date2 – $date1;
switch ($interval) {
case “w”: $retval = bcdiv($timedifference ,604800); break;
case “d”: $retval = bcdiv( $timedifference,86400); break;
case “h”: $retval = bcdiv ($timedifference,3600); break;
case “n”: $retval = bcdiv( $timedifference,60); break;
case “s”: $retval = $timedifference; break;
}
return $retval;}
?
将上面的代码存为datediff.inc文件,然后运行下面的代码:
?
include(‘datediff.inc’);
include(‘dateadd.inc’);
$currenttime = time();
echo “Current time: “. strftime(“%Hh%M %A %d %b” ,$currenttime).”br”;
$newtime = DateAdd (“n”,50 ,$currenttime);
echo “Time plus 50 minutes: “. strftime(“%Hh%M %A %d %b” ,$newtime).”br”;
$temptime = DateDiff (“n”,$currenttime ,$newtime);
echo “Interval between two times: “.$temptime;
?
如果一切顺利,你可以看到以下结果:
Current time: 16h23 Saturday 03 Jun
Time plus 50 minutes: 17h13 Saturday 03 Jun
Interval between two times: 50
如果你在Unix机器上运行PHP,你必须编译PHP支持BC高精度函数。你必须从以下地址http://www.php.net/extra/number4.tar.gz下载BC库,然后将其解压到PHP4的根目录下,重新编译PHP,编译时要加上–enable-bcmath的选项。(详细说明见PHP4中README.BCMATH)。PHP4的Windows版本则不需要做任何修补即可直接使用BC高精度函数。
现在你已经得到处理日期和时间的函数,剩下的就是如何将其运用到你的PHP程序中。

Read: 763

基于PHP的AJAX技术实现文件异步上传

  异步的文件上传是在现代的AJAX实现的Web应用里面经常要遇到,必须解决的问题。但是标准的AJAX类(XmlHttpRequest)无法实现传输文件的功能。因此,这里讨论的内容就是如何在AJAX的技术的基础之上构建异步的文件上传功能。在这个功能当中需要使用到内置的框及(IFRAME)来传输文件。这个功能实现的效果是页面在上传文件的时候,用户还可以使用该页面并且填写文件描述。

  这个例子是我们引用AJAX的经典案例进行分析的。

  系统环境

  · 较新版本的浏览器。例如Opera,Firefox或者 Internet Explorer。

  · PHP 4.3.0 或更高版本

  · PHP 5 版本

  · PHP 中的 ‘short_open_tag’ 选项开启(否则会发生解析错误)。

  功能分析

  通过内置的IFRAME(框架)进行文件上传。具备包括三个部分组成。

  · 在页面中间有一个简单的<form…表单,表单只包含了<input type=”file” … >控件。这个表单的目标链接就是一个隐藏得IFRAME(通过 CSS的风格” display: none;”实现)并且表单里面唯一一个控件的OnChange事件用来触发JavaScript函数。这个函数的作用是检查用户提交的扩展名,然后提交表单。

  · 在服务器端用PHP编写了一个处理过程(用FILEFRAME坐注释了)。这个处理过程用来把从客户端上传的文件进行检查后保存在服务器,并且通过Javascript代码的形式返回给用户。返回给用户的Javascript脚本通过”parent.window.document”更改了用户现在正在查看的页面,设置了文件的名称并启用了让用户提交表单的按钮。启用按钮的操作是通过getElementById函数实现的。

  · 在主页面还有一个表单,它包含了用户提交的描述和隐藏的文件名。用户可以在文件上传的同时填写文件的描述。当文件上传结束以后,用户点击按钮,就可以看上传以后返回给用户的文件信息了。(通过返回来的文件名和用户输入的描述构成文件信息)。

  可能你会说这么操作不符合常理:文件在用户确认之前就已经被提交了。如果用户没有提交的话,情况会如何呢。你可以自己在扩展处理被用户放弃的文件。

  这个例子把文件存储在一个文件系统的目录下。你需要在脚本开始运行的时候配置下这个目录,具体的包含这个目录信息的变量是$upload_dir 和$web_upload_dir。这里有一个对目录是否可写的权限检查。

  这里我们用到了以下几个PHP函数:

  · move_uploaded_file – 转移一经上传到服务器的文件

  · fopen – 打开文件

  · fwrite – 把内容写入文件

  · fclose – 关闭文件

  · str_replace – 替换字符串

  · filesize – 返回文件大小

  · filemtime – 返回处理时间

  你可以通过手册查到这些函数如果使用。请注意要把HTM(<, >, &)标记替换为(<, > 和 &).

    源代码

<?php
$upload_dir = “/var/www/anyexample/aeu”; // 文件存储的路径
$web_upload_dir = “/aeu”; // 文件在Web目录下的路径
$tf = $upload_dir.’/’.md5(rand()).”.test”;
$f = @fopen($tf, “w”);
if ($f == false)
die(“Fatal error! {$upload_dir} is not writable. Set ‘chmod 777 {$upload_dir}’
or something like this”);
fclose($f);
unlink($tf);

//处理上传的文件
if (isset($_POST[‘fileframe’]))
{
 $result = ‘ERROR’;
 $result_msg = ‘No FILE field found’;

 if (isset($_FILES[‘file’])) // 从浏览器接受文件
 {
  if ($_FILES[‘file’][‘error’] == UPLOAD_ERR_OK) // 没有错误
  {
   $filename = $_FILES[‘file’][‘name’]; // 文件名
   move_uploaded_file($_FILES[‘file’][‘tmp_name’], $upload_dir.’/’.$filename);
   // 处理的主过程-转移文件到 $upload_dir
   $result = ‘OK’;
  }
  elseif ($_FILES[‘file’][‘error’] == UPLOAD_ERR_INI_SIZE)
   $result_msg = ‘The uploaded file exceeds the upload_max_filesize directive in php.ini’;
  else
   $result_msg = ‘Unknown error’;
 }

 echo ‘<html><head><title>-</title></head><body>’;
 echo ‘<script language=”JavaScript” type=”text/javascript”>’.”n”;
 echo ‘var parDoc = window.parent.document;’;
 ’
 if ($result == ‘OK’)
 {
  echo ‘parDoc.getElementById(“upload_status”).value = “file successfully uploaded”;’;
  echo ‘parDoc.getElementById(“filename”).value = “‘.$filename.'”;’;
  echo ‘parDoc.getElementById(“filenamei”).value = “‘.$filename.'”;’;
  echo ‘parDoc.getElementById(“upload_button”).disabled = false;’;
 }
 else
 {
  echo ‘parDoc.getElementById(“upload_status”).value = “ERROR: ‘.$result_msg.'”;’;
 }

 echo “n”.’</script></body></html>’;
 exit();
}

function safehtml($s)
{
 $s=str_replace(“&”, “&”, $s);
 $s=str_replace(“<”, “<”, $s);
 $s=str_replace(“>”, “>”, $s);
 $s=str_replace(“‘”, “'”, $s);
 $s=str_replace(“””, “"”, $s);
 return $s;
}

if (isset($_POST[‘description’]))
{
 $filename = $_POST[‘filename’];
 $size = filesize($upload_dir.’/’.$filename);
 $date = date(‘r’, filemtime($upload_dir.’/’.$filename));
 $description = safehtml($_POST[‘description’]);

 $html =<<<END
 <html><head><title>{$filename} [uploaded by IFRAME Async file uploader]</title></head>
 <body>
  <h1>{$filename}</h1>
  <p>This is a file information page for your uploaded file. Bookmark it, or send to anyone…</p>
  <p>Date: {$date}</p>
  <p>Size: {$size} bytes</p>
  <p>Description:
  <pre>{$description}</pre>
  </p>
  <p><a href=”{$web_upload_dir}/{$filename}” style=”font-size: large;”>download file</a><br>
  <a href=”{$PHP_SELF}” style=”font-size: small;”>back to file uploading</a><br>
  <a href=”{$web_upload_dir}/upload-log.html” style=”font-size: small;”>upload-log</a></p>
  <br><br>Example by <a href=”http://www.anyexample.com/”>AnyExample</a>
 </body></html>
 END;
 
 $f = fopen($upload_dir.’/’.$filename.’-desc.html’, “w”);
 fwrite($f, $html);
 fclose($f);
 $msg = “File {$filename} uploaded,
 <a href='{$web_upload_dir}/{$filename}-desc.html’>see file information page</a>”;

 $f = fopen($upload_dir.”/upload-log.html”, “a”);
 fwrite($f, “<p>$msg</p>n”);
 fclose($f);

 setcookie(‘msg’, $msg);
 header(“Location: http://”.$_SERVER[‘HTTP_HOST’].$PHP_SELF);
 exit();
}

if (isset($_COOKIE[‘msg’]) && $_COOKIE[‘msg’] != ”)
{
 if (get_magic_quotes_gpc())
  $msg = stripslashes($_COOKIE[‘msg’]);
 else
  $msg = $_COOKIE[‘msg’];
  setcookie(‘msg’, ”);
}
?>
<!– Beginning of main page –>
<html><head>
<title>IFRAME Async file uploader example</title>
</head>
<body>
<?php
 if (isset($msg))
  echo ‘<p style=”font-weight: bold;”>’.$msg.’</p>’;
?>
<h1>Upload file:</h1>
<p>File will begin to upload just after selection. </p>
<p>You may write file description, while you file is being uploaded.</p>

<form action=”<?=$PHP_SELF?>” target=”upload_iframe” method=”post” enctype=”multipart/form-data”>
 <input type=”hidden” name=”fileframe” value=”true”>
 <!– Target of the form is set to hidden iframe –>
 <!– From will send its post data to fileframe section of this PHP script (see above) –>

 <label for=”file”>text file uploader:</label><br>
 <!– JavaScript is called by OnChange attribute –>
 <input type=”file” name=”file” id=”file” onChange=”jsUpload(this)”>
</form>
<script type=”text/javascript”>
/* This function is called when user selects file in file dialog */
function jsUpload(upload_field)
{
 // this is just an example of checking file extensions
 // if you do not need extension checking, remove
 // everything down to line
 // upload_field.form.submit();
 
 var re_text = /.txt|.xml|.zip/i;
 var filename = upload_field.value;

 /* Checking file type */
 if (filename.search(re_text) == -1)
 {
  alert(“File does not have text(txt, xml, zip) extension”);
  upload_field.form.reset();
  return false;
 }

 upload_field.form.submit();
 document.getElementById(‘upload_status’).value = “uploading file…”;
 upload_field.disabled = true;
 return true;
}
</script>
<iframe name=”upload_iframe” style=”width: 400px; height: 100px; display: none;”>
</iframe>
<!– For debugging purposes, it’s often useful to remove
“display: none” from style=”” attribute –>

<br>
Upload status:<br>
<input type=”text” name=”upload_status” id=”upload_status”
value=”not uploaded” size=”64″ disabled>
<br><br>

File name:<br>
<input type=”text” name=”filenamei” id=”filenamei” value=”none” disabled>

<form action=”<?=$PHP_SELF?>” method=”POST”>
 <!– one field is “disabled” for displaying-only. Other, hidden one is for sending data –>
 <input type=”hidden” name=”filename” id=”filename”>
 <br><br>

 <label for=”photo”>File description:</label><br>
 <textarea rows=”5″ cols=”50″ name=”description”></textarea>

 <br><br>
 <input type=”submit” id=”upload_button” value=”save file” disabled>
</form>
<br><br>
<a href=”<?=$web_upload_dir?>/upload-log.html”>upload-log</a>
<br><br><br>

Example by <a href=”http://www.anyexample.com/”>AnyExample</a>
</body>
</html>

  以上的讲解就是提供一种思路供大家参考。大家也可以根据自己的需求进行相应的优化。

Read: 632

一个别人PHP的分页类

<?
/**
* filename: ext_page.class.php
* @package:phpbean
* @author :feifengxlq<feifengxlq#gmail.com><[url=http://www.phpobject.net/]http://www.phpobject.net/[/url]>
* @copyright :Copyright 2006 feifengxlq
* @license:version 2.0
* @create:2006-5-31
* @modify:2006-6-1
* @modify:feifengxlq 2006-11-4
* description:超强分页类,四种分页模式,默认采用类似baidu,google的分页风格。
* 2.0增加功能:支持自定义风格,自定义样式,同时支持PHP4和PHP5,
* to see detail,please visit [url=http://www.phpobject.net/blog/read.php]http://www.phpobject.net/blog/read.php[/url]?
* example:
* 模式四种分页模式:
    require_once(‘../libs/classes/page.class.php’);
    $page=new page(array(‘total’=>1000,’perpage’=>20));
    echo ‘mode:1<br>’.$page->show();
    echo ‘<hr>mode:2<br>’.$page->show(2);
    echo ‘<hr>mode:3<br>’.$page->show(3);
    echo ‘<hr>mode:4<br>’.$page->show(4);
    开启AJAX:
    $ajaxpage=new page(array(‘total’=>1000,’perpage’=>20,’ajax’=>’ajax_page’,’page_name’=>’test’));
    echo ‘mode:1<br>’.$ajaxpage->show();
    采用继承自定义分页显示模式:
    demo:http://www.phpobject.net/blog
*/
class page
{
/**
   * config ,public
   */
var $page_name=”PB_page”;//page标签,用来控制url页。比如说xxx.php?PB_page=2中的PB_page
var $next_page=’>’;//下一页
var $pre_page='<‘;//上一页
var $first_page=’First’;//首页
var $last_page=’Last’;//尾页
var $pre_bar='<<‘;//上一分页条
var $next_bar=’>>’;//下一分页条
var $format_left='[‘;
var $format_right=’]’;
var $is_ajax=false;//是否支持AJAX分页模式

/**
   * private
   *
   */
var $pagebarnum=10;//控制记录条的个数。
var $totalpage=0;//总页数
var $ajax_action_name=”;//AJAX动作名
var $nowindex=1;//当前页
var $url=””;//url地址头
var $offset=0;

/**
   * constructor构造函数
   *
   * @param array $array[‘total’],$array[‘perpage’],$array[‘nowindex’],$array[‘url’],$array[‘ajax’]…
   */
function page($array)
{
   if(is_array($array)){
      if(!array_key_exists(‘total’,$array))$this->error(__FUNCTION__,’need a param of total’);
      $total=intval($array[‘total’]);
      $perpage=(array_key_exists(‘perpage’,$array))?intval($array[‘perpage’]):10;
      $nowindex=(array_key_exists(‘nowindex’,$array))?intval($array[‘nowindex’]):”;
      $url=(array_key_exists(‘url’,$array))?$array[‘url’]:”;
   }else{
      $total=$array;
      $perpage=10;
      $nowindex=”;
      $url=”;
   }
   if((!is_int($total))||($total<0))$this->error(__FUNCTION__,$total.’ is not a positive integer!’);
   if((!is_int($perpage))||($perpage<=0))$this->error(__FUNCTION__,$perpage.’ is not a positive integer!’);
   if(!empty($array[‘page_name’]))$this->set(‘page_name’,$array[‘page_name’]);//设置pagename
   $this->_set_nowindex($nowindex);//设置当前页
   $this->_set_url($url);//设置链接地址
   $this->totalpage=ceil($total/$perpage);
   $this->offset=($this->nowindex-1)*$this->perpage;
   if(!empty($array[‘ajax’]))$this->open_ajax($array[‘ajax’]);//打开AJAX模式
}
/**
   * 设定类中指定变量名的值,如果改变量不属于这个类,将throw一个exception
   *
   * @param string $var
   * @param string $value
   */
function set($var,$value)
{
   if(in_array($var,get_object_vars($this)))
      $this->$var=$value;
   else {
    $this->error(__FUNCTION__,$var.” does not belong to PB_Page!”);
   }
  
}
/**
   * 打开倒AJAX模式
   *
   * @param string $action 默认ajax触发的动作。
   */
function open_ajax($action)
{
   $this->is_ajax=true;
   $this->ajax_action_name=$action;
}
/**
   * 获取显示”下一页”的代码
   *
   * @param string $style
   * @return string
   */
function next_page($style=”)
{
   if($this->nowindex<$this->totalpage){
    return $this->_get_link($this->_get_url($this->nowindex+1),$this->next_page,$style);
   }
   return ‘<span class=”‘.$style.'”>’.$this->next_page.'</span>’;
}

/**
   * 获取显示“上一页”的代码
   *
   * @param string $style
   * @return string
   */
function pre_page($style=”)
{
   if($this->nowindex>1){
    return $this->_get_link($this->_get_url($this->nowindex-1),$this->pre_page,$style);
   }
   return ‘<span class=”‘.$style.'”>’.$this->pre_page.'</span>’;
}

/**
   * 获取显示“首页”的代码
   *
   * @return string
   */
function first_page($style=”)
{
   if($this->nowindex==1){
       return ‘<span class=”‘.$style.'”>’.$this->first_page.'</span>’;
   }
   return $this->_get_link($this->_get_url(1),$this->first_page,$style);
}

/**
   * 获取显示“尾页”的代码
   *
   * @return string
   */
function last_page($style=”)
{
   if($this->nowindex==$this->totalpage){
       return ‘<span class=”‘.$style.'”>’.$this->last_page.'</span>’;
   }
   return $this->_get_link($this->_get_url($this->totalpage),$this->last_page,$style);
}

function nowbar($style=”,$nowindex_style=”)
{
   $plus=ceil($this->pagebarnum/2);
   if($this->pagebarnum-$plus+$this->nowindex>$this->totalpage)$plus=($this->pagebarnum-$this->totalpage+$this->nowindex);
   $begin=$this->nowindex-$plus+1;
   $begin=($begin>=1)?$begin:1;
   $return=”;
   for($i=$begin;$i<$begin+$this->pagebarnum;$i++)
   {
    if($i<=$this->totalpage){
     if($i!=$this->nowindex)
         $return.=$this->_get_text($this->_get_link($this->_get_url($i),$i,$style));
     else
         $return.=$this->_get_text(‘<span class=”‘.$nowindex_style.'”>’.$i.'</span>’);
    }else{
     break;
    }
    $return.=”n”;
   }
   unset($begin);
   return $return;
}
/**
   * 获取显示跳转按钮的代码
   *
   * @return string
   */
function select()
{
   $return='<select name=”PB_Page_Select” >’;
   for($i=1;$i<=$this->totalpage;$i++)
   {
    if($i==$this->nowindex){
     $return.='<option value=”‘.$i.'” selected>’.$i.'</option>’;
    }else{
     $return.='<option value=”‘.$i.'”>’.$i.'</option>’;
    }
   }
   unset($i);
   $return.='</select>’;
   return $return;
}

/**
   * 获取mysql 语句中limit需要的值
   *
   * @return string
   */
function offset()
{
   return $this->offset;
}

/**
   * 控制分页显示风格(你可以增加相应的风格)
   *
   * @param int $mode
   * @return string
   */
function show($mode=1)
{
   switch ($mode)
   {
    case ‘1’:
     $this->next_page=’下一页’;
     $this->pre_page=’上一页’;
     return $this->pre_page().$this->nowbar().$this->next_page().’第’.$this->select().’页’;
     break;
    case ‘2’:
     $this->next_page=’下一页’;
     $this->pre_page=’上一页’;
     $this->first_page=’首页’;
     $this->last_page=’尾页’;
     return $this->first_page().$this->pre_page().'[第’.$this->nowindex.’页]’.$this->next_page().$this->last_page().’第’.$this->select().’页’;
     break;
    case ‘3’:
     $this->next_page=’下一页’;
     $this->pre_page=’上一页’;
     $this->first_page=’首页’;
     $this->last_page=’尾页’;
     return $this->first_page().$this->pre_page().$this->next_page().$this->last_page();
     break;
    case ‘4’:
     $this->next_page=’下一页’;
     $this->pre_page=’上一页’;
     return $this->pre_page().$this->nowbar().$this->next_page();
     break;
    case ‘5’:
     return $this->pre_bar().$this->pre_page().$this->nowbar().$this->next_page().$this->next_bar();
     break;
   }
  
}
/*—————-private function (私有方法)———————————————————–*/
/**
   * 设置url头地址
   * @param: String $url
   * @return boolean
   */
function _set_url($url=””)
{
   if(!empty($url)){
       //手动设置
    $this->url=$url.((stristr($url,’?’))?’&’:’?’).$this->page_name.”=”;
   }else{
       //自动获取
    if(empty($_SERVER[‘QUERY_STRING’])){
        //不存在QUERY_STRING时
     $this->url=$_SERVER[‘REQUEST_URI’].”?”.$this->page_name.”=”;
    }else{
        //
     if(stristr($_SERVER[‘QUERY_STRING’],$this->page_name.’=’)){
         //地址存在页面参数
      $this->url=str_replace($this->page_name.’=’.$this->nowindex,”,$_SERVER[‘REQUEST_URI’]);
      $last=$this->url[strlen($this->url)-1];
      if($last==’?’||$last==’&’){
          $this->url.=$this->page_name.”=”;
      }else{
          $this->url.=’&’.$this->page_name.”=”;
      }
     }else{
         //
      $this->url=$_SERVER[‘REQUEST_URI’].’&’.$this->page_name.’=’;
     }//end if    
    }//end if
   }//end if
}

/**
   * 设置当前页面
   *
   */
function _set_nowindex($nowindex)
{
   if(empty($nowindex)){
    //系统获取
   
    if(isset($_GET[$this->page_name])){
     $this->nowindex=intval($_GET[$this->page_name]);
    }
   }else{
       //手动设置
    $this->nowindex=intval($nowindex);
   }
}
  
/**
   * 为指定的页面返回地址值
   *
   * @param int $pageno
   * @return string $url
   */
function _get_url($pageno=1)
{
   return $this->url.$pageno;
}

/**
   * 获取分页显示文字,比如说默认情况下_get_text(‘<a href=””>1</a>’)将返回[<a href=””>1</a>]
   *
   * @param String $str
   * @return string $url
   */
function _get_text($str)
{
   return $this->format_left.$str.$this->format_right;
}

/**
    * 获取链接地址
*/
function _get_link($url,$text,$style=”){
   $style=(empty($style))?”:’class=”‘.$style.'”‘;
   if($this->is_ajax){
       //如果是使用AJAX模式
    return ‘<a ‘.$style.’ href=”javascript:’.$this->ajax_action_name.'(”.$url.”)”>’.$text.'</a>’;
   }else{
    return ‘<a ‘.$style.’ href=”‘.$url.'”>’.$text.'</a>’;
   }
}
/**
    * 出错处理方式
*/
function error($function,$errormsg)
{
      die(‘Error in file <b>’.__FILE__.'</b> ,Function <b>’.$function.'()</b> :’.$errormsg);
}
}
?>

Read: 553

PHP V5.2 中的新增功能,第 2 部分: 使用新输入过滤扩展功能

2007 年 4 月 17 日

在 “PHP V5.2 中的新增功能” 这一系列的第 2 部分中,了解如何有效使用新的 PHP V5.2 提供的新输入过滤扩展功能。这是一项急需的功能,它将允许您验证表单和其他输入介质的输入而无需依赖第三方软件。阅读本文后,您将能有效地过滤输入以提高应用程序的安全性。

本文是共有五部分的系列文章的第二部分,我们将继续介绍 PHP V5.2 的新增功能,本文主要介绍输入过滤。

接 受用户输入或来自不受信任来源的任何其他数据是 PHP 开发人员在开发应用程序时可能承担的最常见风险之一。您经常需要引入来自未知来源的数据以使应用程序运行,但是这就给黑客提供了插入任意代码或以其他方式 使用应用程序的机会。从 PHP V5.2 开始,输入过滤扩展功能将被默认启用,以使您可以更轻松地针对此类操作采取措施。输入过滤扩展功能提供了一组函数来解析和检查输入,然后在函数中使用此输 入。

我们将考察使用这些函数解析和检查输入而不进行手动编码的原因,并介绍一些如何使用这些新函数的基本示例。

从任何一个位置输入

输 入是大多数应用程序的关键。我们的应用程序将接收大量信息并使用微处理器的能力来处理这些信息。我们可以控制输入进入应用程序的位置,但是我们不能控制输 入此数据的用户的意图。PHP 最初被开发为一种轻松的方法,用于开发从 HTML 表单收集输入的脚本。它现在的功能早已不限于此了,但是我们现在仍然在用它来收集和操作来自许多不受信任的源的数据。即使是单独的数据输入职员也可能无意 识地向应用程序发送一些问题数据,甚至也必须将其视为不受信任的源。

安全是目前十分热门的问题,并且随着每次 通过的硬件和软件修订而变得更加热门。我们总是说得很好听,但是由于情况很复杂,因此我们往往在系统保护的关键点 —— 输入上做得差强人意。方法有很多并且实现起来很复杂。我们完成应用程序有严格的最后期限并且必须履行项目经理的最后期限。

保护自己免于恶意代码攻击的一种方法是确保接收到预期的输入。在本文中,我们将查看一个阻止用户输入不适当的 JavaScript 的示例,并向您展示如何将那些标记从输入中剥离出来,返回实际需要的内容。

PHP V5.0 以后的版本中提供了输入过滤扩展功能以使您可以更轻松地获得安全性。PHP V5.2 版本首次默认启用了此功能并实现了开箱即用。


回页首

验证与过滤的对比

在您的编程经历中可能听说过术语:输入验证。 它是应用程序开发过程中至关重要的部分,用于确保传入数据在上下文和内容上都是正确的。程序员可以通过正则表达式和测试来查看值是否满足标准(例如,要求 输入电子邮件地址并需要确保输入格式正确时)。如果需要排除 Hotmail 或 Gmail 等免费电子邮件地址,也可以借助此方法。您将使用正则表达式来阻止包含 “hotmail.com” 或 “gmail.com” 的任何电子邮件地址。

通常认为这类 “处理基本检查以确保输入数据满足某种标准” 就是验证。在这种情况下,需要确保不必清理数据,或者确实可获得查找的数据。验证的目标就是要避免一些简单错误,例如尝试将 NULL 放入不接受这种值的字段。

错 误的数据或恶意构造的数据导致的错误可能带来毁灭性的后果。您将需要全力实现一种更全面的过滤此信息的方法,这种方法需涵盖针对每种数据类型的所有可能测 试,而不是执行千篇一律的任务或重复的任务。通常,您可能没注意到测试或编写不完整的正则表达式。过滤器扩展功能将帮助提供更完整的输入评估,同时减少重 复代码编写工作。在这种情况下,过滤与验证的不同之处就在于过滤在安全性上更全面。


回页首

过滤器类型以及如何选择

让我们进一步查看扩展功能的详细信息。过滤扩展功能有两种过滤器:Sanitizing 和 Logical。

Sanitizing 过滤器只是允许或禁止字符串中的字符并将清理后的字符串作为结果返回。无论您将哪种数据格式传入这些函数,它们将始终返回字符串。对于特定类型的使用,这 是至关重要的,因为您可以阻止用户发送不适当的输入并导致异常结果。例如,用户可以发现文本块的输入被返回到以下页面上并且要利用那些返回信息。如果清理 输入,则将删除输入的所有危险部分。

Logical 过滤器将对变量执行测试并根据测试提供 true 或 false 结果。然后您可以使用结果来决定如何处理数据或获得用户的地址。这种过滤器的简单示例是验证年龄。逻辑测试还可以针对类似 Perl 的正则表达式进行测试。

让我们看看在进行过滤和验证时使用这些函数的一些方法,了解如何将过滤引入应用程序。


回页首

整理行为

让我们开始使用过滤扩展功能的清理应用程序来过滤不需要的代码块。

在 这个示例应用程序中,您有一张简单的表单,它接收三个问题和三个答案。表单本身没有使用验证或过滤。查看源代码时,一个不幸的用户相信这是真的,并且决定 通过编写包括抛出警报的 JavaScript 调用的文本块来测试表单。如果警报弹出,告诉他输入的所有内容都将真正被接受并由应用程序使用而不进行过滤,这将证明他是正确的。

清单 1. 简单输入表单

                
<html>
<body>
<p>What is your name?</p>
<form name="form1" method="get" action="filteringexample1a.php">
<p>
<input name="1" type="text" id="1">
</p>
<p>What is your favorite color?</p>
<p>
<input name="2" type="text" id="2">
</p>
<p>What is the airspeed of an unladen swallow?</p>
<p>
<textarea name="3" id="3"></textarea>
</p>
<p>
<input type="submit" name="Submit" value="Submit">
</p>
</form>
</body>
</html>

清单 1 是接受用户输入的常见 HTML 表单。要求用户提供一些基本信息并且简单地将其返回,而不进行任何其他操作。在图 1 中,您可以看到用户已经输入了一些信息并准备发送 JavaScript 代码,如果不完成清理工作,这段 JavaScript 代码将发送警报。

图 1. 输入表单
输入表单

接下来,创建一个脚本来捕获表单变量并在另一个页面中将其打印输出。

清单 2. PHP 表单

                
<body>

<?php

echo "You are " . $_GET['1'] . ".<br>n";
echo "Your favorite color is " . $_GET['2'] . ".<br>n";
echo "The airspeed of an unladen swallow is " . $_GET['3'] . ".<br>n";

?>

</body>

现在您可以看到如果只是返回这个输入而不使用任何类型的过滤将会发生什么情况。

图 2. 表单的输出
表单的输出

如您所见,不幸的用户已经执行了一些随机代码。假定,这段代码只位于客户端(不幸用户自己的 PC 计算在内,并且在这种情况下不表示对应用程序构成威胁),但是它肯定不是有效输入。


回页首

清理输入字符串

清单 3 演示了使用 filter_var()FILTER_SANITIZE_STRING 选项进行清理的简单示例。

清单 3. 添加代码到接收 PHP 脚本中

                
<?php

echo "You are " . filter_var($_GET['1'], FILTER_SANITIZE_STRING) . ".<br>n";
echo "Your favorite color is " . filter_var($_GET['2'], FILTER_SANITIZE_STRING) .
".<br>n";
echo "The airspeed of an unladen swallow is " . filter_var($_GET['3'], FILTER_SANITIZE_STRING)
. ".<br>n";
?>

如您所见,开始使用 filter_var() 函数来清理输入并使其有效并且安全。在这种情况下,使用选项 FILTER_SANITIZE_STRING,该选项将获取输入、删除所有 HTML 标记并选择性地编码或删除特定字符。

由于它将除去 HTML 标记,因此尝试运行 JavaScript 将失败,并且从脚本中获得更适当的结果。

图 3. 从修订后的 PHP 脚本获得的清理后的输出
从修订后的 PHP 脚本获得的清理后的输出

与尝试用正则表达式和字符串函数手动完成此工作相比,使用 filter_var() 函数将极大地减少编码量。在那种情况下,您将必须编写只执行 HTML 代码块的另外若干行代码和显式正则表达式,并且解析整个输入的文本块以确保没有遗漏任何 HTML 标记。而使用提供的函数将更简单。


回页首

用户输入 —— 毫无逻辑

一 些输入是数字或有指定的式样。在这些情况下,您可以使用逻辑过滤选项并针对表达式或其他逻辑测试检查数据。如果表达式读到 true,则数据将成功通过过滤器。如果逻辑测试证明数据为 false,则数据将不能通过过滤器。首先,我们将设置一个简单的逻辑测试用于检查确保燕子坠落的速度在规定的范围内,因为燕子的空中速度可能不同。设置 完测试后,我们将添加一些代码来告诉用户答案是否不正确。正确答案应当只需重复。

清单 4. 添加代码到接收 PHP 脚本中

                
<?php
echo "You are " . $_GET['1'] . ".<br>n";
echo "Your favorite color is " . $_GET['2'] . ".nn";

$minSpeed = 12;
$maxSpeed = 13;

$airspeed = filter_var($_GET['3'], FILTER_VALIDATE_INT, array("options" =>
array("min_range"=>$minSpeed, "max_range"=>$maxSpeed)));

echo "The airspeed of an unladen swallow is " . $airspeed . ".nn";
?>

清单 4 将根据速度的最小值和最大值范围检查坠落的燕子问题的答案。这可以简单地确保它确实是一个 INT 变量,但是也在 $minSpeed$maxSpeed 中添加了一个范围。如果用户答案不在可接受的值的范围内,结果将得到 FALSE。随后可以测试这个答案并且把正确答案返回给用户。在这种情况下,我们将直言不讳。

清单 5. 添加代码到接收 PHP 脚本中

                
<?php
echo "You are " . $_GET['1'] . ".<br>n";
echo "Your favorite color is " . $_GET['2'] . ".nn";

$minSpeed = 12;
$maxSpeed = 13;

$airspeed = filter_var($_GET['3'], FILTER_VALIDATE_INT, array("options" =>
array("min_range"=>$minSpeed, "max_range"=>$maxSpeed)));

If ($airspeed === FALSE){
Echo "<h1>WRONG!</h1>";
}else{

echo "The airspeed of an unladen swallow is " . $airspeed . ".nn";
}
?>

我们已经遵从逻辑测试成功地测试了传入数据,并且向用户显示了正确结果或者一些负面的反馈。不管怎样,我们已经使用了过滤器来确保为输入提供了正确答案。


回页首

结束语

分享这篇文章……

digg 将本文提交到 Digg
del.icio.us 发布到 del.icio.us
Slashdot 提交到 Slashdot!

PHP V5.2 中的新增功能” 这一系列文章(共五部分)的第 2 部分集中介绍了输入过滤。我们查看了以下两者的差异:简单输入验证以捕获不要求任何清理的简单错误,以及旨在捕获潜在的更具破坏性的输入错误和问题的输入 过滤。然后查看了两种类型的过滤扩展功能:Sanitizing 和 Logical,并浏览了两者的示例。在第 3 部分中,我们将查看新的 JSON 扩展功能,它将为 PHP 开发人员开发 Ajax 应用程序(使用 JSON 的)提供更好的支持。

Read: 694

PHP V5.2 中的新增功能,第 1 部分: 使用新的内存管理器

2007 年 4 月 10 日

了解如何使用 PHP V5.2 中引入的新内存管理器并开始精通于跟踪和监视内存使用情况。这将使您可以在 PHP V5.2 中更加有效地使用更多的内存。

PHP V5.2:开始

2006 年 11 月发布了 PHP V5.2,它包括许多新增功能和错误修正。它废止了 5.1 版并被推荐给所有 PHP V5 用户进行升级。我最喜欢的实验室环境 —— Windows®、Apache、MySQL、PHP (WAMP) —— 已经被引入了 V5.2 的新软件包中(请参阅 参考资料)。您将在那里找到在 Windows® XP 或 2003 计算机上安装 PHP V5.2、MySQL 和 Apache 的应用程序。您可以十分轻松地进行安装,它有很多不错的小的管理优点,并且我十分诚恳地推荐使用它。

虽然对于 Windows 用户来说,这是最简单的软件包,但是在 Linux 上配置 PHP 时您需要添加以下代码:--memory-limit-enabled(适用于您服务器的任何其他选项除外)。不过,在 Windows 下,提供了一个解决此问题的函数。

PHP V5.2 中有很多改进之处,并且一个至关重要的领域是内存管理。从 README.ZEND_MM 中准确地引述就是:“新内存管理器(PHP5.2 以及更高版本)的目标是减少内存分配开销并加速内存管理。”

下面是 V5.2 发行说明中的一些关键内容:

  • 删除了不必要的 --disable-zend-memory-manager 配置选项
  • 添加了 --enable-malloc-mm 配置选项,调试构建时此配置选项将被默认启用以允许使用内部和外部内存调试程序
  • 允许使用 ZEND_MM_MEM_TYPEZEND_MM_SEG_SIZE 环境变量调整内存管理器

为了理解这些新增功能的含义,我们需要深入研究内存管理中的艺术,并考虑为什么分配开销和运行速度是大问题。


回页首

为什么进行内存管理?

计 算中开发最快速的一项技术是内存和数据存储,它们是受不断增加速度和存储大小这样持续的需求而驱动的。早期的计算机使用卡作为内存,然后转向了芯片技术。 您能想象在只有 1 KB RAM 内存的计算机工作的情景吗?很多早期的计算机程序员就曾使用过。这些先驱者很快就意识到,要在技术限制下工作,他们将必须细心地用琐碎的命令避免系统过 载。

身为 PHP 开发人员,与使用 C++ 或其他更严格的语言编码的同事相比,我们所在的环境更方便进行编码。在我们的世界里,我们自己不必担心如何处理系统内存,因为 PHP 将为我们处理这个问题。但是,在其他编程领域里,负责任的编码人员将使用各种函数确保执行的命令不会覆盖其他一些程序数据 —— 因而,破坏了程序的运行。

内存管理通常是由来自编码人员的请求处理的,以分配和释放内存块。分配块 可以保存任何类型的数据,并且此过程将为该数据隔开一定量的内存,并当操作需要访问数据时为应用程序提供访问方法。人们期望程序在完成任何操作后释放分配的内存,并允许系统和其他程序员使用该内存。如果程序没有把内存释放回系统,则称为内存泄露

泄露是任何运行程序都存在的普遍问题,并且某种程度内通常是可以接受的,尤其是当我们知道运行程序将立即终止并释放默认分配给程序的所有内存。

由 于随机运行和终止程序,像几乎所有客户机应用程序一样,这是个问题。期望服务器应用程序不确定地运行而不终止或重新启动,这使得内存管理对于服务器守护程 序编程绝对的至关重要。在长时间运行的程序中,即使一个小的泄露最后都将发展为系统衰弱问题,因为内存块已被使用并且永远不被释放。


回页首

长期考虑

正如使用任何语言编写一样,用 PHP 编写的永久性服务器守护程序有很多可能的用途。但是当我们出于这些目的开始使用 PHP 时,我们也必须考虑内存使用情况。

解 析大量数据或可能隐藏无限次循环的脚本都趋于消耗大量内存。很明显,一旦内存被耗尽,服务器的性能就降低,因此在执行脚本时我们还必须注意内存的使用情 况。虽然我们可以通过启用系统监视器来简单观察内存的使用量,但是它不会告诉我们比整个系统内存状态更有用的任何内容。有时我们不止需要帮助进行故障检修 或优化的内容,而有时我们只是需要更多详细信息。

获得脚本执行内容的透明性的一种方法是使用内部或外部调试器。内部调试器 是呈现为执行脚本的相同的进程。从操作系统的角度考虑的独立进程是外部调试器。使用调试器进行内存分析类似于任何一种情况,但是使用了不同的方法访问内存。内部调试器对运行进程所在的内存空间具有直接访问权,而外部调试器将通过套接字访问内存。

有许多方法和可用的调试服务器(外部)和库(内部)可用于辅助开发。为了准备好对 PHP 安装进行调试,可以使用新提供的 --enable-malloc-mm,它在 DEBUG 构建中默认被启用。这使环境变量 USE_ZEND_ALLOC 可用于允许在运行时选择 mallocemalloc 内存分配。使用 malloc-type 内存分配将允许外部调试器观察内存使用情况,而 emalloc 分配将使用 Zend 内存管理器抽象,要求进行内部调试。


回页首

PHP 中的内存管理函数

除了使内存管理器更灵活更透明之外,PHP V5.2 还为 memory_get_usage()memory_get_peak_usage() 提供了一个新参数,这两个函数允许查看内存使用量。说明中提及的新布尔值是 real_size。通过调用函数 memory_get_usage($real);(其中 $real = true),结果将为调用时系统中实际分配的内存大小,包括内存管理器开销。如果不使用标记组,则返回的数据将只包括在运行脚本内使用的内存,减去内存管理器开销。

memory_get_usage()memory_get_peak_usage() 的不同之处在于后者将返回到目前为止调用它的运行进程的最高内存量,而前者只返回执行时的使用量。

对于 memory_get_usage(),php.net 提供了清单 1 中的代码片段。

清单 1. memory_get_usage() 示例

    
<?php

// This is only an example, the numbers below will
// differ depending on your system

echo memory_get_usage() . "n"; // 36640
$a = str_repeat("Hello", 4242);
echo memory_get_usage() . "n"; // 57960
unset($a);
echo memory_get_usage() . "n"; // 36744

?>

在这个简单示例中,我们首先回转了直接调用 memory_get_usage() 的结果,代码注释中显示可能在作者的系统中有 36640 字节的常见结果。然后我们使用 4,242 个 “Hello” 副本来装载 $a 并再次运行函数。图 1 中可以看到此简单应用的输出。

图 1. memory_get_usage() 的示例输出
memory_get_usage() 的示例输出

没有 memory_get_peak_usage() 的示例,因为两者十分相似,语法是相同的。但是,对于清单 1 中的示例代码,将只有一个结果,即当时的最高内存使用量。让我们看一看清单 2。

清单 2. memory_get_peak_usage() 示例

    
<?php

// This is only an example, the numbers below will
// differ depending on your system

echo memory_get_peak_usage() . "n"; // 36640
$a = str_repeat("Hello", 4242);
echo memory_get_peak_usage() . "n"; // 57960
unset($a);
echo memory_get_peak_usage() . "n"; // 36744

?>

清单 2 中的代码跟图 1 一样,但是 memory_get_usage() 已经替换为 memory_get_peak_usage()。在我们用 4242 个 “Hello” 副本填充 $a 之前,输出都不会有多大更改。内存跳升至 57960,表示到目前为止的峰值。当检查内存使用量峰值时,得到了目前为止的最高值,因此所有进一步调用都将得到 57960,直至我们处理的操作比处理 $a 使用的内存更多(参见图 2)。

图 2. memory_get_peak_usage() 的示例输出
memory_get_peak_usage() 的示例输出


回页首

限制内存使用

确 保托管应用程序的服务器不过载的一种方法是限制 PHP 执行的任何脚本使用的内存量。这根本不是我们应当执行的操作,但由于 PHP 是一种松散类型的语言,并且是在运行时解析的,因此我们有时会获得在释放到生产应用程序中后编写得很差的脚本。这些脚本可能执行循环,也可能打开一张长的 文件列表,忘记在打开新文件之前先关闭当前文件。无论在哪一种情况下,编写很差的脚本可能在您知道之前以消耗大量内存告终。

在 PHP.INI 中,您可以使用配制参数 memory_limit 来指定任何脚本能够在系统中运行的最大内存使用量。这不是对于 V5.2 的特定更改,但是内存管理器及其使用的任何讨论都值得至少快速查看一次这个特性。它还精心地引导我使用内存管理器的最后几个新功能:环境变量。


回页首

调整内存管理器

最后,在不能做完美主义者但是又完全符合自己目的的情况下怎样编程?新环境变量 ZEND_MM_MEM_TYPEZEND_MM_SEG_SIZE 正好可以满足您的需求。

当内存管理器分配大型内存块时,它是安装 ZEND_MM_SEG_SIZE 变量中列出的预定大小执行操作的。这些内存块的默认分区大小为每块 256 KB,但是您可以调整这些分区大小以满足特殊需求。例如,如果您注意到最常用的一个脚本中的操作导致大量的内存浪费,则可以将此大小调整为更接近匹配脚本 需求的值,减少分配的内存量但剩下的内存量仍然为零。在正确的条件下,此类谨慎的配制调整可能造成巨大差别。


回页首

在 Windows 中检索内存使用情况

如果具有预构建的 PHP Windows 二进制代码,而没有在构建时使用 --enable-memory-limit 选项,则需要先浏览此部分然后再继续。对于 Linux®,配置 PHP 构建时用 --enable-memory-limit 选项构建 PHP。

要使用 Windows 二进制代码检索内存使用情况,请创建以下函数。

清单 3. 在 Windows 下获得内存使用情况

    
<?php

function memory_get_usage(){
$output = array();
exec('tasklist /FI "PID eq '.getmypid().'" /FO LIST', $output );
return preg_replace( '/[^0-9]/', '', $output[5] ) * 1024;
}

?>

将结果保存到名为 function.php 的文件。现在您只能将此文件包含在需要使用它的脚本中。


回页首

动手实践

让 我们来看一看使用这些设置的实际示例给我们带来的好处。可能有很多次您都想知道为什么在脚本的末尾没有正确分配内存。原因是因为一些函数本身导致了内存泄 露,尤其是在仅使用内置 PHP 函数的情况下。在这里,您将了解如何发现此类问题。并且为了开始进行内存泄露查找的征战,您将创建一个测试 MySQL 数据库,如清单 4 所示。

清单 4. 创建测试数据库

    
mysql> create database memory_test;

mysql> use memory_test;

mysql> create table leak_test
( id int not null primary key auto_increment,
data varchar(255) not null default '');

mysql> insert into leak_test (data) values ("data1"),("data 2"),
("data 3"),("data 4"),("data 5"),("data6"),("data 7"),
("data 8"),("data 9"),("data 10");

这将创建一个带有 ID 字段和数据字段的简单表。

在下一张清单中,想象我们坚韧不拔的程序员正在执行一些 MySQL 函数,特别是使用 mysql_query() 将结果应用到变量。当他这样做时,他将注意到即使调用 mysql_free_result(),一些内存也不会被释放,导致内存使用量随着 Apache 进程不断增长(参见清单 5)。

清单 5. 内存泄露检测示例

    
for ( $x=0; $x<300; $x++ ) {
$db = mysql_connect("localhost", "root", "test");
mysql_select_db("test");
$sql = "SELECT data FROM test";
$result = mysql_query($sql); // The operation suspected of leaking
mysql_free_result($result);
mysql_close($db);
}

清单 5 是在任何位置都可能使用的简单 MySQL 数据库操作。在运行脚本时,我们注意到一些与内存使用量相关的奇怪行为并需要将其检查出来。为了使用内存管理函数以使我们可以检验发生错误的位置,我们将使用以下代码。

清单 6. 定标查找错误的示例

    
<?php

if( !function_exists('memory_get_usage') ){
include('function.php');
}

echo "At the start we're using (in bytes): ",
memory_get_usage() , "n<br>";

$db = mysql_connect("localhost", "user", "password");
mysql_select_db("memory_test");

echo "After connecting, we're using (in bytes): ",
memory_get_usage(),"n<br>";

for ( $x=0; $x<10; $x++ ) {
$sql =
"SELECT data FROM leak_test WHERE id='".$x."'";
$result = mysql_query($sql); // The operation
// suspected of leaking.
echo "After query #$x, we're using (in bytes): ",
memory_get_usage(), "n<br>";
mysql_free_result($result);
echo "After freeing result $x, we're using (in bytes): ",
memory_get_usage(), "n<br>";
}

mysql_close($db);
echo "After closing the connection, we're using (in bytes): ",
memory_get_usage(), "n<br>";
echo "Peak memory usage for the script (in bytes):".
memory_get_peak_usage();

?>

注:按照定义的时间间隔检查当前内存使用量。在下面的输出中,通过显示我们的脚本一直在为函数分配内存,并且在应当释放的时候没有释放内存,从而提供对内存泄露的实际测试,您可以看到每次调用时内存使用量如何增长。

清单 7. 测试脚本输出

    
At the start we're using (in bytes): 63216
After connecting, we're using (in bytes): 64436
After query #0, we're using (in bytes): 64760
After freeing result 0, we're using (in bytes): 64828
After query #1, we're using (in bytes): 65004
After freeing result 1, we're using (in bytes): 65080
After query #2, we're using (in bytes): 65160
After freeing result 2, we're using (in bytes): 65204
After query #3, we're using (in bytes): 65284
After freeing result 3, we're using (in bytes): 65328
After query #4, we're using (in bytes): 65408
After freeing result 4, we're using (in bytes): 65452
After query #5, we're using (in bytes): 65532
After freeing result 5, we're using (in bytes): 65576
After query #6, we're using (in bytes): 65656
After freeing result 6, we're using (in bytes): 65700
After query #7, we're using (in bytes): 65780
After freeing result 7, we're using (in bytes): 65824
After query #8, we're using (in bytes): 65904
After freeing result 8, we're using (in bytes): 65948
After query #9, we're using (in bytes): 66028
After freeing result 9, we're using (in bytes): 66072
After closing the connection, we're using (in bytes): 65108
Peak memory usage for the script (in bytes): 88748

我们所做的操作是发现了执行脚本时出现的一些可疑操作,然后调整脚本使其给我们提供一些可理解的反馈。我们再次运行了脚本,在每次迭代期间使用 memory_get_usage() 查看内存使用量的变化。根据分配的内存值的增长情况,暗示了我们用脚本在某个位置建立了一个漏洞。由于 mysql_free_result() 函数不释放内存,因此我们可以认为 mysql_query() 并未正确分配内存。

Read: 687