自定義 PHP 分頁函數

root 文件共享 電腦語言與程式設計 PHP 自定義 PHP 分頁函數
自定義 PHP 分頁函數
中文 PHP 資訊站 不詳 www.unixphp.com/php-article/90
farmer
每次編寫列表性質的頁面，幾乎都要寫上一段分頁的程式。最近小陽終於決心一勞永逸--自定義一個分頁函數，並保存在"pageft.php"文件裡。要用到分頁的地方，就直接包含"pageft.php"文件，並調用這個函數就行了。小陽在編寫這個函數時，儘量注意了程式的可攜性和易用性，下面就是小陽編寫的函數：

//為了避免重複包含文件而造成錯誤，加了判斷函數是否存在的條件：
if(!function_exists(pageft)){
//定義函數pageft(),三個參數的含義為：
//$totle：資訊總數；
//$displaypg：每頁顯示資訊數，這裡設置默認是20；
//$url：分頁導航中的鏈結，除了加入不同的查詢資訊"page"外的部分都與這個URL相同。
//預設值本該設為本頁URL（即$_SERVER["REQUEST_URI"]），但設置預設值的右邊只能為常量，所以該預設值設為空字串，在函數內部再設置為本頁URL。

function pageft($totle,$displaypg=20,$url=''){
//定義幾個總體變數：
//$page：當前頁碼；
//$firstcount：（資料庫）查詢的起始項；
//$pagenav：頁面導航條代碼，函數內部並沒有將它輸出；
//$_SERVER：讀取本頁URL"$_SERVER["REQUEST_URI"]"所必須。
global $page,$firstcount,$pagenav,$_SERVER;
//為使函數外部可以訪問這裡的"$displaypg"，將它也設為總體變數。注意一個變數重新定義為總體變數後，原值被覆蓋，所以這裡給它重新賦值。
$GLOBALS["displaypg"]=$displaypg;
if(!$page) $page=1;
//如果$url使用默認，即空值，則賦值為本頁URL：
if(!$url){ $url=$_SERVER["REQUEST_URI"];}
//URL分析：
$parse_url=parse_url($url);
$url_query=$parse_url["query"]; //單獨取出URL的查詢字串
if($url_query){
//因為URL中可能包含了頁碼資訊，我們要把它去掉，以便加入新的頁碼資訊。
//這裡用到了正則運算式，請參考本站的相關文章
$url_query=ereg_replace("(^|&)page=$page","",$url_query);
//將處理後的URL的查詢字串替換原來的URL的查詢字串：
$url=str_replace($parse_url["query"],$url_query,$url);

//在URL後加page查詢資訊，但待賦值：
if($url_query) $url.="&page"; else $url.="page";
}else {
$url.="?page";
}

//頁碼計算：
$lastpg=ceil($totle/$displaypg); //最後頁，也是總頁數
$page=min($lastpg,$page);
$prepg=$page-1; //上一頁
$nextpg=($page==$lastpg ? 0 : $page+1); //下一頁
$firstcount=($page-1)*$displaypg;
//開始分頁導航條代碼：
$pagenav="顯示第 ".($totle?($firstcount+1):0)."-".min($firstcount+$displaypg,$totle)." 條記錄，共 $totle 條記錄
";
//如果只有一頁則跳出函數：
if($lastpg<=1) return false;
$pagenav.=" 首頁 ";
if($prepg) $pagenav.=" 前頁 "; else $pagenav.=" 前頁 ";
if($nextpg) $pagenav.=" 後頁 "; else $pagenav.=" 後頁 ";
$pagenav.=" 尾頁 ";
//下拉跳轉列表，迴圈列出所有頁碼：
$pagenav.=" 到第 \n";
for($i=1;$i<=$lastpg;$i++){
if($i==$page) $pagenav.="$i\n";
else $pagenav.="$i\n";
}
$pagenav.=" 頁，共 $lastpg 頁";
}
}
?>


好，分頁函數已經寫好了，保存為"pageft.php"，要分頁時就包含它並調用pageft()函數。不過它並沒有輸出任何東西，但產生幾個總體變數供使用：$firstcount、$displaypg、$pagenav。


下面舉例說明它的用法：

//（前面程式略）
include("pageft.php"); //包含"pageft.php"文件
//取得總資訊數
$result=mysql_query("select * from mytable");
$total=mysql_num_rows($result);
//調用pageft()，每頁顯示10條資訊（使用默認的20時，可以省略此參數），使用本頁URL（默認，所以省略掉）。
pageft($total,10);
//現在產生的總體變數就派上用場了：
$result=mysql_query("select * from mytable limit $firstcount,$displaypg ");
while($row=mysql_fetch_array($result)){
//（列表內容略）
}
//輸出分頁導航條代碼：
echo $pagenav;
//（後面程式略）
?>