## 分頁
MixPHP 的分頁類采用的一種非常靈活的設計方式,分頁的構建都由視圖層完成,可以構建任意結構的分頁式樣。
| 類 | 調用 |
| --- | --- |
| Mix\Pagination\Paginator | new Paginator([配置]); |
## 安裝
```
composer require mix/pagination
```
>[danger] 該類默認代碼未包含, 需自行安裝。
## 模型范例
MixPHP 建議用戶在模型中使用分頁類,因為在模型內更加方便獲取分頁數據,分頁數據可隨分頁對象由控制器傳遞至視圖。
~~~
// 模型內的方法
public function getPaginator($page)
{
return new Paginator([
// 數據結果集
'items' => $data,
// 數據總行數
'count' => 987,
// 當前頁,值 >= 1
'page' => $page,
// 每頁顯示數量
'perPage' => 10,
// 固定最小最大頁碼
'fixedMinMax' => true,
// 鏈接數量
'links' => 5,
]);
}
~~~
## 視圖范例
我們設計了三個常用的分頁式樣,使用 bootstrap 的用戶可直接復制代碼使用,使用其他前端框架的用戶只需修改相關的 HTML 即可。
### 1. 帶上下頁且固定最小最大頁

~~~
<?php if ($paginator->display()): ?>
<nav aria-label="Page navigation">
<ul class="pagination">
<?php if ($paginator->hasPrev()): ?>
<li><a href="/?page=<?= $paginator->prev(); ?>">上一頁</a></li>
<?php else: ?>
<li class="disabled"><span>上一頁</span></a></li>
<?php endif; ?>
<?php foreach ($paginator->numbers() as $number): ?>
<?php if ($number->text == 'ellipsis'): ?>
<li class="disabled"><span>...</span></li>
<?php else: ?>
<li <?= $number->selected ? 'class="active"' : ''; ?>><a href="/?page=<?= $number->text; ?>"><?= $number->text; ?></a></li>
<?php endif; ?>
<?php endforeach; ?>
<?php if ($paginator->hasNext()): ?>
<li><a href="/?page=<?= $paginator->next(); ?>">下一頁</a></li>
<?php else: ?>
<li class="disabled"><span>下一頁</span></a></li>
<?php endif; ?>
</ul>
</nav>
<p><?php echo "當前第 ", $paginator->page, " 頁,共 ", $paginator->pages, " 頁"; ?></p>
<?php endif; ?>
~~~
### 2. 純數字固定最小最大頁

~~~
<?php if ($paginator->display()): ?>
<nav aria-label="Page navigation">
<ul class="pagination">
<?php foreach ($paginator->numbers() as $number): ?>
<?php if ($number->text == 'ellipsis'): ?>
<li class="disabled"><span>...</span></li>
<?php else: ?>
<li <?= $number->selected ? 'class="active"' : ''; ?>><a href="/?page=<?= $number->text; ?>"><?= $number->text; ?></a></li>
<?php endif; ?>
<?php endforeach; ?>
</ul>
</nav>
<p><?php echo "當前第 ", $paginator->page, " 頁,共 ", $paginator->pages, " 頁"; ?></p>
<?php endif; ?>
~~~
### 3. 帶首尾頁上下頁

~~~
<?php if ($paginator->display()): ?>
<nav aria-label="Page navigation">
<ul class="pagination">
<?php if ($paginator->hasFirst()): ?>
<li><a href="/">首頁</a></li>
<?php else: ?>
<li class="disabled"><span>首頁</span></a></li>
<?php endif; ?>
<?php if ($paginator->hasPrev()): ?>
<li><a href="/?page=<?= $paginator->prev(); ?>">上一頁</a></li>
<?php else: ?>
<li class="disabled"><span>上一頁</span></a></li>
<?php endif; ?>
<?php foreach ($paginator->numbers() as $number): ?>
<li <?= $number->selected ? 'class="active"' : ''; ?>><a href="/?page=<?= $number->text; ?>"><?= $number->text; ?></a></li>
<?php endforeach; ?>
<?php if ($paginator->hasNext()): ?>
<li><a href="/?page=<?= $paginator->next(); ?>">下一頁</a></li>
<?php else: ?>
<li class="disabled"><span>下一頁</span></a></li>
<?php endif; ?>
<?php if ($paginator->hasLast()): ?>
<li><a href="/?page=<?= $paginator->totalPages; ?>">尾頁</a></li>
<?php else: ?>
<li class="disabled"><span>尾頁</span></a></li>
<?php endif; ?>
</ul>
</nav>
<p><?php echo "當前第 ", $paginator->page, " 頁,共 ", $paginator->pages, " 頁"; ?></p>
<?php endif; ?>
~~~
- 歡迎使用 MixPHP
- 安裝說明
- 全量安裝
- Phar 命令行
- 入門須知
- 增改應用
- 命名空間
- 自動加載
- 入口文件
- 配置文件
- 服務開發
- 核心基礎
- Bean
- Component
- Application
- 命令行
- 簡介
- 命令行開發常識
- 命令行開發
- 創建命令
- 命令參數
- 打印與顏色
- 控制臺程序
- 守護程序
- HTTP 服務
- 簡介
- 服務器
- 路由
- 請求
- 響應
- 控制器
- 視圖
- Auth
- Session
- 文件上傳
- 其他組件
- 分頁
- 驗證碼
- 圖片處理
- 客戶端
- GuzzleHttp
- 雜項
- Apache/PHP-FPM部署
- 調試與錯誤
- 安全建議
- WebSocket 服務
- 簡介
- 服務器
- 注冊器
- 連接
- 客戶端
- 測試
- 雜項
- nginx代理
- 60s無消息斷線
- TCP 服務
- 簡介
- 服務器
- 客戶端
- 測試
- UDP 服務
- 簡介
- 服務器
- 客戶端
- 測試
- 協程
- 簡介
- 開啟協程
- PHP Stream Hook
- xgo + Channel
- WaitGroup + xdefer
- 連接池
- 協程池
- 定時器
- 公共組件
- 中間件
- 驗證器
- 驗證器定義
- 驗證規則
- 靜態調用
- 模型
- 日志
- 緩存
- 數據庫
- Database
- QueryBuilder
- PDOConnection
- Persistent\PDOConnection
- Coroutine\PDOConnection
- MasterSlave\PDOConnection
- ExecuteListener
- Redis
- RedisConnection
- Persistent\RedisConnection
- Coroutine\RedisConnection
- ExecuteListener
- 常見問題
- 同一臺服務器部署多個服務
- 連接多個數據庫
- 如何設置跨域
- form-data 上傳文件失敗
- 開發工具
- 版本更新
- 不兼容改動
- 升級指南
- 文檔歷史