萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 陣列分頁實現:基於 array_slice 的輕量級分頁邏輯

針對小規模資料集(< 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 頁)

效能優化建議

  1. 快取完整陣列:Redis/Memcached 儲存序列化陣列,分頁時反序列化後 array_slice
  2. 生成器模式:PHP 5.5+ 使用 yield 惰性載入,配合 LimitIterator
  3. 預計算分頁索引:大陣列建立 [page => [offset, length]] 索引表,避免重複計算

原生 array_slice 參數詳解

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  保留原始鍵名(關聯陣列必須)

掌握陣列分頁技巧,能在適當場景下以最少代碼實現完整分頁體驗。

copyright © 萬盛學電腦網 all rights reserved