針對小規模資料集(< 1000 筆)或已載入記憶體的陣列資料,使用 array_slice() 實現分頁比資料庫 LIMIT 更簡潔。本文提供可直接復用的分頁函數,含頁碼導航生成、邊界處理、URL 參數管理。
<?php
/**
* 陣列分頁函數
* @param array $data 完整資料陣列
* @param int $pageSize 每頁筆數
* @param int $page 當前頁碼(從 1 開始)
* @return array 包含 data(當頁資料)、pagination(導航HTML)、total(總筆數)、totalPages(總頁數)、currentPage(當前頁)
*/
function array_paginate(array $data, int $pageSize = 10, int $page = 1): array {
$total = count($data);
$totalPages = (int)ceil($total / $pageSize);
// 邊界修正
$page = max(1, min($page, $totalPages ?: 1));
// 計算偏移並切片
$offset = ($page - 1) * $pageSize;
$pageData = array_slice($data, $offset, $pageSize, true); // true 保留鍵名
// 生成導航 HTML
$pagination = '';
if ($totalPages > 1) {
$baseUrl = '?' . http_build_query(array_merge($_GET, ['page' => '']));
$pagination = '<nav aria-label="Pagination"><ul class="pagination">';
// 首頁/上一頁
$pagination .= '<li><a href="' . $baseUrl . '1">首頁</a></li>';
$pagination .= '<li><a href="' . $baseUrl . max(1, $page - 1) . '">上一頁</a></li>';
// 頁碼範圍(顯示當前頁前後各 2 頁)
$start = max(1, $page - 2);
$end = min($totalPages, $page + 2);
for ($i = $start; $i <= $end; $i++) {
$class = $i === $page ? ' class="active"' : '';
$pagination .= "<li$class><a href=\"{$baseUrl}{$i}\">$i</a></li>";
}
// 下一頁/末頁
$pagination .= '<li><a href="' . $baseUrl . min($totalPages, $page + 1) . '">下一頁</a></li>';
$pagination .= '<li><a href="' . $baseUrl . $totalPages . '">末頁</a></li>';
$pagination .= '</ul></nav>';
}
return [
'data' => $pageData,
'pagination' => $pagination,
'total' => $total,
'totalPages' => $totalPages,
'currentPage' => $page,
];
}
<?php
// 模擬資料來源(實際可來自 API、檔案、Session、快取)
$allItems = range(1, 100); // 100 筆資料
// 取得當前頁碼(預設第 1 頁)
$currentPage = isset($_GET['page']) ? max(1, (int)$_GET['page']) : 1;
// 執行分頁
$result = array_paginate($allItems, 10, $currentPage);
// 輸出資料
echo '<ul class="item-list">';
foreach ($result['data'] as $key => $value) {
echo "<li>項目 #$key: $value</li>";
}
echo '</ul>';
// 輸出分頁導航
echo $result['pagination'];
// 除錯資訊
echo "<p>共 {$result['total']} 筆,第 {$result['currentPage']}/{$result['totalPages']} 頁</p>";
?>
function buildPageUrl(int $page): string {
$params = $_GET;
$params['page'] = $page;
return '?' . http_build_query($params);
}
// 在 pagination 生成中使用
$pagination .= '<li><a href="' . buildPageUrl($i) . '">' . $i . '</a></li>';
| 適用場景 | 不適用場景 |
|---|---|
| 靜態/半靜態資料(配置表、字典、小型報表) | 資料量 > 5000 筆(記憶體壓力大) |
| API 回應已載入完整集合 | 需要複雜排序/篩選(應下推資料庫) |
| 原型快速開發、Admin 後台小表格 | 高併發寫入場景(資料一致性難保證) |
| 前端分頁組件(Vue/React)資料預載 | 需支援深度分頁(如第 10000 頁) |
array_sliceyield 惰性載入,配合 LimitIterator[page => [offset, length]] 索引表,避免重複計算array_slice(array $array, int $offset, int|null $length = null, bool $preserve_keys = false): array
$offset > 0 從開頭向後計數
$offset < 0 從結尾向前計數(-1 為最後一個)
$length > 0 返回元素數量
$length < 0 結尾前保留元素數量
$preserve_keys = true 保留原始鍵名(關聯陣列必須)
掌握陣列分頁技巧,能在適當場景下以最少代碼實現完整分頁體驗。