PHP 實現數組分頁

Posted on by

今天，我們就來學習一下可以實現這個能力的一些函數技巧。

首先，我們還是準備好測試數據。

$data = [
    'A',
    'B',
    'C',
    'D',
    'E',
    'F',
    'G',
    'H',
    'I',
    'J',
    'K',
];

// $p = $_GET['p'];
$p = 2;
$currentPage = $p <= 1 ? 0 : $p - 1;
$pageSize = 3;
$offset = $currentPage * $pageSize;

假設 \$data 就是從數據庫中取出的全部數據，或者就是我們寫死在 PHP 代碼中的數據。然後我們設定 $p 為接收到的請求參數，當前訪問的是第二頁。$currentPage 是用於查詢偏移量的修正，在代碼開發的世界中，下標索引都是從0開始的，所以我們需要對接收到的參數進行減一的操作。當然，你也可以設定前端傳遞的參數就是以 0 為第一頁的。這個就不多解釋瞭，相信大傢隻要正式的學習或者參與過開發項目都會明白它的意思。

然後我們定義瞭當前頁面所顯示的信息條數 $pageSize ，也就是隻獲取 3 條數據。最後，我們計算瞭一下偏移量，也就是類似於 MySQL 的 LIMIT 中的那個參數。它的作用就是告訴我們從第幾條開始查詢，然後配合 $pageSize 查詢幾條。這樣我們就可以獲得當前頁面對應的數據瞭。（貌似把分頁的原理都講瞭一下）

array_slice

第一個也是最基礎和最常見的分頁方式，就是使用 array_slice() 函數來實現。它的作用是從數組中截取出一段內容來並返回這段內容的數組。

var_dump(array_slice($data, $offset, $pageSize));
// array(3) {
//     [0]=>
//     string(1) "D"
//     [1]=>
//     string(1) "E"
//     [2]=>
//     string(1) "F"
//   }

array_slice() 函數需要三個參數，第二個參數就是偏移量，第三個參數是查詢幾條數據。其中，第三個參數是可選的，不填的話就會把當前設定的偏移量之後的數據全部顯示出來。是不是和我們的 MySQL 查詢語句一模一樣。沒錯，他們本身就是類似的操作。

array_chunk

array_chunk() 函數則是根據一個數值參數將一個數組進行分組，也就是將數組分割成一段一段的子數組。我們就可以根據分割後的數組來獲取指定下標的子數組內容，這些內容就是當前的頁面需要展示的數據瞭。

$pages = array_chunk($data, $pageSize);
var_dump($pages);
// array(4) {
//     [0]=>
//     array(3) {
//       [0]=>
//       string(1) "A"
//       [1]=>
//       string(1) "B"
//       [2]=>
//       string(1) "C"
//     }
//     [1]=>
//     array(3) {
//       [0]=>
//       string(1) "D"
//       [1]=>
//       string(1) "E"
//       [2]=>
//       string(1) "F"
//     }
//     [2]=>
//     array(3) {
//       [0]=>
//       string(1) "G"
//       [1]=>
//       string(1) "H"
//       [2]=>
//       string(1) "I"
//     }
//     [3]=>
//     array(2) {
//       [0]=>
//       string(1) "J"
//       [1]=>
//       string(1) "K"
//     }
//   }

var_dump($pages[$currentPage]);
// array(3) {
//     [0]=>
//     string(1) "A"
//     [1]=>
//     string(1) "B"
//     [2]=>
//     string(1) "C"
//   }

這段代碼我們輸出瞭分割後的數組內容，然後需要的是第二頁也就是下標為 1 的數據，直接通過分割後的數組就可以方便地獲取到所需要的內容瞭。使用這個函數來做數組分頁的功能非常地簡單直觀，而且它不需要去計算偏移量，直接就是使用當前頁 $currentPage 和 $pageSize 就可以完成對於數據的分組瞭，非常推薦大傢使用這個函數來進行類似的操作。

LimitIterator

最後我們要學習到的是使用一個迭代器類來實現數組分頁的能力，這個使用的就比較少瞭，估計都沒什麼人知道，但其實 LimitIterator 類在 PHP5.1 時就已經提供瞭。它的作用是允許遍歷一個 Iterator 的限定子集的元素。也就是說，如果我們的代碼中使用瞭迭代器模式，實現瞭迭代器接口，那麼這些迭代器類都可以使用這個類進行分頁操作。

foreach (new LimitIterator(new ArrayIterator($data), $offset, $pageSize) as $d) {
    var_dump($d);
}
// string(1) "D"
// string(1) "E"
// string(1) "F"

它需要的實例化構造參數包含3個，第一個是一個迭代器對象，由於數組不是迭代器對象，所以我們使用 ArrayIterator 實例將我們的數組數據轉化為一個迭代器對象。後面兩個參數就是偏移量和數據數量瞭，這個和 array_slice() 函數是類似的，不過不同的是，它的偏移量參數也是可以選的。如果我們不給後面的可選參數的話，那麼它將遍歷所有的數據。

foreach (new LimitIterator(new ArrayIterator($data)) as $d) {
    var_dump($d);
}
// string(1) "A"
// string(1) "B"
// string(1) "C"
// string(1) "D"
// string(1) "E"
// string(1) "F"
// string(1) "G"
// string(1) "H"
// string(1) "I"
// string(1) "J"
// string(1) "K"

參數錯誤時的表現

接下來，我們看看如果參數錯誤，也就是偏移量或者所需的數據量大小有問題的話，這些操作將會有什麼樣的表現。

var_dump(array_slice($data, $offset, 150));
// array(8) {
//     [0]=>
//     string(1) "D"
//     [1]=>
//     string(1) "E"
//     [2]=>
//     string(1) "F"
//     [3]=>
//     string(1) "G"
//     [4]=>
//     string(1) "H"
//     [5]=>
//     string(1) "I"
//     [6]=>
//     string(1) "J"
//     [7]=>
//     string(1) "K"
//   }
var_dump(array_slice($data, 15, $pageSize));
// array(0) {
// }

array_slice() 函數對於偏移量錯誤的兼容就是展示一個空的數組。而數據量超標的話則會展示所有偏移量之後的數據。

var_dump($pages[15]);
// NULL

array_chunk() 對於下標不存在的數據當然就是返回一個 NULL 值啦。

foreach (new LimitIterator(new ArrayIterator($data), $offset, 150) as $d) {
    var_dump($d);
}
// string(1) "D"
// string(1) "E"
// string(1) "F"
// string(1) "G"
// string(1) "H"
// string(1) "I"
// string(1) "J"
// string(1) "K"

foreach (new LimitIterator(new ArrayIterator($data), 15, $pageSize) as $d) {
    var_dump($d);
}
// Fatal error: Uncaught OutOfBoundsException: Seek position 15 is out of range

LimitIterator 則是對於偏移量錯誤的數據直接返回錯誤異常信息瞭。這也是類模式處理的好處，有錯誤都會以異常的形式進行返回，方便我們對異常進行後續的處理。

其它的測試大傢還可以自行檢測，比如偏移是 0 或者是負數的情況，數據量是 0 或者是負數的情況。這些我就不多寫瞭，大傢可以根據已有的知識先猜想一下結果會是什麼樣的，然後再自己寫代碼驗證一下結果是符合自己的預期，這樣學習的效果會非常棒哦！（在下方測試代碼鏈接中有測試，結果裡面是有坑的哦）

總結

一個功能使用瞭三種方式來實現，這就是代碼的魅力。至於哪個好哪個壞我們不多做評價，一切都是以業務為核心來進行選取。類似的功能雖說並不常見，但很多項目裡都會遇到，比如說後臺用戶組管理就會非常常見，一般來說後臺用戶分組如果不是特別大型的 ERP 項目都不會很多，但有時候也會達到需要分頁的程度，這時候，我們就可以考慮考慮使用今天所學的知識來做咯！

測試代碼

以上就是PHP 實現數組分頁的詳細內容，更多關於PHP 數組分頁的資料請關註WalkonNet其它相關文章！

推薦閱讀：