分頁 · ThinkPHP5.1完全開發手冊

## 分頁實現 `ThinkPHP5.1`內置了分頁實現，要給數據添加分頁輸出功能變得非常簡單，可以直接在`Db`類查詢的時候調用`paginate`方法： ~~~ // 查詢狀態為1的用戶數據并且每頁顯示10條數據 $list?=?Db::name('user')->where('status',1)->paginate(10); // 把分頁數據賦值給模板變量list $this->assign('list',?$list); // 渲染模板輸出 return?$this->fetch(); ~~~ 也可以改成模型的分頁查詢代碼： ~~~ // 查詢狀態為1的用戶數據并且每頁顯示10條數據 $list?=?User::where('status',1)->paginate(10); // 把分頁數據賦值給模板變量list $this->assign('list',?$list); // 渲染模板輸出 return?$this->fetch(); ~~~ 模板文件中分頁輸出代碼如下： ~~~html <div> <ul> {volist name='list' id='user'} <li> {$user.nickname}</li> {/volist} </ul> </div> {$list|raw} ~~~ 也可以單獨賦值分頁輸出的模板變量 ~~~ // 查詢狀態為1的用戶數據并且每頁顯示10條數據 $list?=?User::where('status',1)->paginate(10); // 獲取分頁顯示 $page?=?$list->render(); // 模板變量賦值 $this->assign('list',?$list); $this->assign('page',?$page); // 渲染模板輸出 return?$this->fetch(); ~~~ 模板文件中分頁輸出代碼如下： ~~~html <div> <ul> {volist name='list' id='user'} <li> {$user.nickname}</li> {/volist} </ul> </div> {$page|raw} ~~~ 默認情況下，生成的分頁輸出是完整分頁功能，帶總分頁數據和上下頁碼，分頁樣式只需要通過樣式修改即可，完整分頁默認生成的分頁輸出代碼為： ~~~ <ul class="pagination"> <li><a href="?page=1">«</a></li> <li><a href="?page=1">1</a></li> <li class="active"><span>2</span></li> <li class="disabled"><span>»</span></li> </ul> ~~~ 如果你需要單獨獲取總的數據，可以使用 ~~~ // 查詢狀態為1的用戶數據并且每頁顯示10條數據 $list?=?User::where('status',1)->paginate(10); // 獲取總記錄數 $count = $list->total(); // 把分頁數據賦值給模板變量list $this->assign('list',?$list); // 渲染模板輸出 return?$this->fetch(); ~~~ ### 傳入總記錄數支持傳入總記錄數而不會自動進行總數計算，例如： ~~~ // 查詢狀態為1的用戶數據并且每頁顯示10條數據總記錄數為1000 $list?=?User::where('status',1)->paginate(10,1000); // 獲取分頁顯示 $page?=?$list->render(); // 模板變量賦值 $this->assign('list',?$list); $this->assign('page',?$page); // 渲染模板輸出 return?$this->fetch(); ~~~ >[danger] 對于`UNION`查詢以及一些特殊的復雜查詢，推薦使用這種方式首先單獨查詢總記錄數，然后再傳入分頁方法 ### 分頁后數據處理支持分頁類后數據直接`each`遍歷處理，方便修改分頁后的數據，而不是只能通過模型的獲取器來補充字段。 ~~~ $list?=?User::where('status',1)->paginate()->each(function($item, $key){ $item->nickname = 'think'; }); ~~~ 如果是`Db`類操作分頁數據的話，`each`方法的閉包函數中需要使用返回值，例如： ~~~ $list?=?Db::name('user')->where('status',1)->paginate()->each(function($item, $key){ $item['nickname'] = 'think'; return $item; }); ~~~ ## 簡潔分頁如果你僅僅需要輸出一個僅僅只有上下頁的分頁輸出，可以使用下面的簡潔分頁代碼： ~~~ // 查詢狀態為1的用戶數據并且每頁顯示10條數據 $list?=?User::where('status',1)->paginate(10,true); // 把分頁數據賦值給模板變量list $this->assign('list',?$list); // 渲染模板輸出 return?$this->fetch(); ~~~ 簡潔分頁模式的輸出代碼為： ~~~ <ul class="pager"> <li><a href="?page=1">«</a></li> <li class="disabled"><span>»</span></li> </ul> ~~~ > 由于簡潔分頁模式不需要查詢總數據數，因此可以提高查詢性能。 ## 分頁參數主要的分頁參數如下： |參數|描述| |---|---| |list_rows|每頁數量| |page|當前頁| | path|url路徑| | query|url額外參數| |fragment|url錨點| |var_page|分頁變量| |type|分頁類名| 分頁參數的設置方式有兩種，第一種是在配置文件`paginate.php`中定義，例如： ~~~ //分頁配置 return [ 'type' => 'bootstrap', 'var_page' => 'page', ]; ~~~ type屬性支持命名空間，例如： ~~~ //分頁配置 return [ 'type' => '\org\page\bootstrap', 'var_page' => 'page', ]; ~~~ 也可以在調用分頁方法的時候傳入，例如： ~~~ $list?=?Db::name('user')->where('status',1)->paginate(10,true,[ 'type' => 'bootstrap', 'var_page' => 'page', ]); ~~~ >[danger] 如果需要在分頁的時候傳入查詢條件，可以使用query參數拼接額外的查詢參數