分頁是網站常用的一項功能,如果有一個良好的分頁類(函數),可以幫開發者節省不少開發時間。
1 分頁要與SQL無關。為什麼分頁必須與SQL無關呢？很顯然，有一定開發經驗的朋友，至少都在使用數據庫代理類。我們不應該在分頁類中global或傳遞數據庫類，至於直接把數據庫連接放進去，那更要不得。另外請看第5點。
2 分頁要與html及樣式分離。與html分離是顯而易見的需要的，首先，就算是同一個網站，也會需要不同風格的分頁，甚至有些用的還是圖片。其次，可以應付不同編碼格式。另外，與html和樣式分離，即相當於PHP的模板技術一處道理，美工可以修改出自己想要的效果。
3 要考慮變數值問題，並非所有分頁都是數字的。比如有些人分頁是page=pn123，甚至是page=p123nfadfafdaf。分頁類要提供這方面的處理。
4 web協議不僅僅限于http。很多分頁類內部就把協議定死了http了，這是不可取的。
僅僅上面最基本的四點，現在所能看到的所謂分頁類中，能做到其中兩個的，基本上沒有。
好吧。我們開始。
5 分頁不僅限于數據庫分頁。有些是對內容的分頁，比如把一篇長達上萬字的內容進行分頁，這樣如果把SQL寫到類裏面的，就更要不得了，一點用也沒有。
BluePage是一個通用的分頁類，它能幫助你更快地完成分頁任務。
先看使用例子: http://www.bluessoft.com/project/bluepage/example.php
使用例子1:
<?php
include ( "lib/BluePage.class.php" ) ;
$pBP = new BluePage ;
$intCount = 1000 ; // 假設記錄總數為1000
$intShowNum = 10 ; // 每頁顯示10
$aPDatas = $pBP->get( $intCount , $intShowNum ) ;
$strHtml = $pBP->getHTML( $aPDatas ) ; //在適當位置輸出或賦值給一個模板變數
?>
|
效果圖:
使用例子2:
<?php
include ( "lib/BluePage.class.php" ) ;
$pBP = new BluePage ;
$intCount = 1000 ; // 假設記錄總數為1000
$intShowNum = 10 ; // 每頁顯示10
$aPDatas = $pBP->get( $intCount , $intShowNum ) ;
//print_r($aPDatas); //如不記得返回,列印出來看看
?>
|
使用例子3:
<?php
include ( "lib/BluePage.class.php" ) ;
$pBP = new BluePage ;
$intCount = 1000 ; // 假設記錄總數為1000
$intShowNum = 10 ; // 每頁顯示10
$aPDatas = $pBP->get( $intCount , $intShowNum ) ;
//第二個參數指定配置文件
$strHtml = $pBP->getHTML( $aPDatas , "myBPDiy.inc.php") ;
?>
|
輸出控制:
<?php
include ( "lib/BluePage.class.php" ) ;
$pBP = new BluePage ;
$intCount = 1000 ; // 假設記錄總數為1000
$intShowNum = 10 ; // 每頁顯示10
$aPDatas = $pBP->get( $intCount , $intShowNum ) ;
// f 首頁
// pg 上一組頁碼
// p 上一頁
// bar 分頁條
// ng 下一組頁碼
// n 下一頁
// m 總頁數
// sl 下拉選頁
// i Input表單
$pBP->_order = 'm|sl' ; //只輸出總頁數與下拉選頁
$strHtml = $pBP->getHTML( $aPDatas ) ;
?>
|
使用例子5
<?php
include ( "lib/BluePage.class.php" ) ;
$pBP = new BluePage ;
$intCount = 1000 ; // 假設記錄總數為1000
$intShowNum = 10 ; // 每頁顯示10
$pBP->_getlink = false ; // 取消取得鏈結
$pBP->_getqs = false ; // 取消取得Query String
//返回分頁數字(省資源)
$aPDatas = $pBP->get( $intCount, $intShowNum );
//print_r($aPDatas); //列印出來看看
//只要最大頁，上一頁，與下一頁和當前頁以及offset返回(最省資源)
$aPDatas = $pBP->get( $intCount, $intShowNum , 0 );
//print_r($aPDatas); //列印出來看看
?>
|
取得offset
<?php
include ( "lib/BluePage.class.php" ) ;
$pBP = new BluePage ;
$intCount = 1000 ; // 假設記錄總數為1000
$intShowNum = 10 ; // 每頁顯示10
$aPDatas = $pBP->get( $intCount, $intShowNum );
$offset = $aPDatas['offset'] ;
?>
|
非數據庫分頁：
比如有一篇文章長度是10000字節，要想每2000字節分為一頁，那怎麼辦呢？
<?php
include ( "lib/BluePage.class.php" ) ;
$pBP = new BluePage ;
$strLen = strlen($strSubContent); //假設內容總長度，這個自己計算取得
$strSubLen = 2000 ; // 每頁數據長度
$aPDatas = $pBP->get( $strLen, $strSubLen );
$offset = $aPDatas["offset"] ;
//取得當前頁的內容
$strSubContent = fn_substr( $strSubContent, $offset , $strSubLen ) ; //截取函數自己寫
?>
|
一些屬性:
8.1 你使用的變數不是page，而是其他，比如是 pn :
<?php
$pBP->_var = 'pn' ;
$aPDatas = $pBP->get( $intCount, $intShowNum );
?>
|
8.2 $this->_prefix有什麼作用?
當你的分頁是類似于page=pp123這樣的數字前面有字符的時候，$this->_prefix就有用了
<?php
$pBP->_prefix = 'pp' ; // 如page=pp123的 pp
$aPDatas = $pBP->get( $intCount, $intShowNum );
?>
|
8.3 $this->_postfix有什麼作用? :
當你的分頁是類似于page=123p這樣的數字後面有字符的時候，$this->_postfix就有用了
<?php
$pBP->_postfix = 'p' ; // 如page=123p的 p
$aPDatas = $pBP->get( $intCount, $intShowNum );
?>
|
8.4 $this->_prefix和$this->_postfix能否同時使用? :
當然可以。當你的分頁是類似于page=pn123ccc 這樣的數字後面有字符的時候，就兩個一起用
<?php
$pBP->_prefix = 'pn' ;
$pBP->_postfix = 'ccc' ;
$aPDatas = $pBP->get( $intCount, $intShowNum );
?>
|
8.5 $this->_pos有什麼用? :
它的作用是 當前頁在分頁條中的位置設定，比如設為3，當前頁是８，那麼數字8就分處在分頁條的第三位即: 6 7 8 9 10 11 12 13 14 15
<?php
$pBP->_pos = 5 ; //把當前頁放到第五位
$aPDatas = $pBP->get( $intCount, $intShowNum );
?>
|
8.6 $this->_symbol有什麼用? :
連接符
<?php
$pBP->_symbol= '&' ; //使用&為鏈結符
$aPDatas = $pBP->get( $intCount, $intShowNum );
?>
|
8.7 $this->_getqs有什麼用? :
是否取得Query String。默認取得，為false則不取得。可節省資源，但如果要取得鏈結與html的時候，它會為true
<?php
$pBP->_getqs = false ;
$aPDatas = $pBP->get( $intCount, $intShowNum );
?>
|
8.8 $this->_getlink有什麼作用? :
this->_getlink默認為true，即表示取得分頁的鏈結，為false時，有關*ln鍵名的變數，都不會有值它的作用在於，1 適用於手工設置鏈結的人 2 節省資源
<?php
$pBP->_getlink = false ;
$aPDatas = $pBP->get( $intCount, $intShowNum );
?>
|
8.9 $this->_encode有什麼作用? :
$this->_encode默認為true，即表示使用htmlspecialchars對Query String過濾
<?php
$pBP->_encode= false ;//不過濾query string
$aPDatas = $pBP->get( $intCount, $intShowNum );
?>
|
最後:
關於BluePage.default.inc.php配置文件
這個是默認的配置文件。你可以將面的內容拷貝一份，保存為另一個配置。比如命名為page.abc.inc.php 假設當前訪問的是list.php文件，在list.php同級目錄下有一目錄保存config，如./config目錄，而你將page.abc.inc.php保存在./config目錄了。
<?php
$pBP->_encode= false ;//不過濾query string
$aPDatas = $pBP->get( $intCount, $intShowNum );
$strHtml = $pBP->getHTML( $aPDatas, './config/page.abc.inc.php' ); //路徑要正確
?>
|
請根據你的頁面輸出編碼，保存相應編碼格式。就像你做模板一樣。
如果你的頁面是utf-8格式的，請保存配置文件為utf-8格式。注意，只是改page.abc.inc.php編碼，類文件的編碼請不要改動。
補充一點:
如果覺得沒有取記錄總數的函數不方便,你可以自已在類裏面加上取總數的函數,或者使用外部函數
我們在實際應用中,取記錄數的方法是跟隨項目對象的,所以一般不加在分頁類裏面.
如果你沒有自己取記錄數的方法,你可以在分頁類中加上,或者加到外部
[php]
程式示例:
<?php
//這是mysql的函數,你可以加一個名為msGetCount的函數支援mssql
//加到類裏面,或作為外部函數
function myGetCount( $strQuery , $pDBC )
{
$resResult = @mysql_query ( $strQuery , $pDBC ) ;
while ( $arrRow = @mysql_fetch_row ( $resResult ) )
{
$intCount = intval($arrRow[0]);
}
@mysql_free_result( $resResult ) ;
return $intCount ;
}
//這是SQLserver的函數
//加到類裏面,或作為外部函數
function msGetCount( $strQuery , $pDBC )
{
$resResult = @mssql_query ( $strQuery , $pDBC ) ;
while ( $arrRow = @mssql_fetch_row ( $resResult ) )
{
$intCount = $arrRow[0];
}
@mssql_free_result( $resResult ) ;
return intval( $intCount ) ;
}
//使用例子
$dbconn = mysql_connect ( 'localhost' , 'dbname' , 'password' ) ;
mysql_select_db( 'yourdb' , $dbconn ) ;
$strQuery = 'SELECT COUNT(`id`) FROM TABLE WHERE 1' ;
include ( "lib/BluePage.class.php" ) ;
$pBP = new BluePage ;
//作為外部函數時
$intCount = myGetCount( $strQuery , $dbconn ) ; //取得了記錄數
//如果是SQLserver
$intCount = msGetCount( $strQuery , $dbconn ) ; //取得了記錄數
//作為類的方法時
$intCount = $pBP->myGetCount( $strQuery , $dbconn ) ;//取得了記錄數
//如果是SQLserver
$intCount = $pBP->msGetCount( $strQuery , $dbconn ) ;//取得了記錄數
$pBP->get( $intCount, 10 ); //取得分頁數據
?>
|
當然,我們並不鼓勵將數據庫操作放入分頁類中
[/php]
主頁地址：http://www.bluessoft.com/project/bluepage/
下載地址：http://www.bluessoft.com/project/bluepage/BluePage.tar.gz
（責任編輯：雲子）
