配置

在其他的框架中，實(shí)現(xiàn)分頁(yè)是令人感到苦惱的事，但是 Laravel 令它實(shí)現(xiàn)起來(lái)變得輕松。 Laravel 可以產(chǎn)生基于當(dāng)前頁(yè)面的智能「范圍」鏈接，所產(chǎn)生的 HTML 兼容 Bootstrap CSS 框架.

使用

有幾種方法來(lái)分頁(yè)對(duì)象。最簡(jiǎn)單的是在搜索構(gòu)建器使用 paginate 方法或 Eloquent 模型。

對(duì)數(shù)據(jù)庫(kù)結(jié)果分頁(yè)

$users = DB::table('users')->paginate(15);

注意： 目前 Laravel 使用 groupBy 來(lái)做分頁(yè)操作無(wú)法有效率的執(zhí)行，如果您需要使用 groupBy 來(lái)分頁(yè)數(shù)據(jù)集，建議您手動(dòng)查找數(shù)據(jù)庫(kù)，并使用 Paginator::make。

手動(dòng)創(chuàng)建分頁(yè)實(shí)例

有時(shí)你也許希望手動(dòng)創(chuàng)建發(fā)呢也實(shí)例，傳遞一個(gè)數(shù)組作為參數(shù)。你可以根據(jù)需求創(chuàng)建 Illuminate\Pagination\Paginator 或者 Illuminate\Pagination\LengthAwarePaginator 實(shí)例。

對(duì) Eloquent 模型分頁(yè)

您也可以對(duì) Eloquent 模型分頁(yè):

$allUsers = User::paginate(15);$someUsers = User::where('votes', '>', 100)->paginate(15);

發(fā)送給 paginate 方法的參數(shù)是您希望每頁(yè)要顯示的對(duì)象選項(xiàng)數(shù)目，只要您取得查找結(jié)果后，您可以在視圖中顯示，并使用 render 方法去建立分頁(yè)鏈接：

<div class="container">
    <?php foreach ($users as $user): ?>
        <?php echo $user->name; ?>
    <?php endforeach; ?></div><?php echo $users->render(); ?>

這就是所有建立分頁(yè)系統(tǒng)的步驟了！您會(huì)注意到我們還沒(méi)有告知 Laravel 我們目前的頁(yè)面是哪一頁(yè)，這個(gè)信息 Laravel 會(huì)自動(dòng)幫您做好。

您也可以通過(guò)以下方法獲得額外的分頁(yè)信息：

• currentPage

• lastPage

• perPage

• hasMorePages

• url

• nextPageUrl

• firstItem

• lastItem

• total

• count

「簡(jiǎn)單分頁(yè)」

如果您只是要在您的分頁(yè)視圖顯示「上一頁(yè)」和「下一頁(yè)」鏈接，您有個(gè)選項(xiàng) simplePaginate 方法來(lái)執(zhí)行更高效率的搜索。當(dāng)您不需要精準(zhǔn)的顯示頁(yè)碼在視圖上時(shí)，這個(gè)方法在較大的數(shù)據(jù)集非常有用：

$someUsers = User::where('votes', '>', 100)->simplePaginate(15);

手動(dòng)建立分頁(yè)

有的時(shí)候您可能會(huì)想要從數(shù)組中對(duì)象手動(dòng)建立分頁(yè)實(shí)體， 您可以根據(jù)您的需要通過(guò) Illuminate\Pagination\Paginator 或 Illuminate\Pagination\LengthAwarePaginator 實(shí)體來(lái)建立。

自定義分頁(yè) URL

您還可以透過(guò) setPath 方法自定義使用的 URL：

$users = User::paginate();$users->setPath('custom/url');

上面的例子將建立 URL，類(lèi)似以下內(nèi)容： http://example.com/custom/url?page=2

追加分頁(yè)鏈接

您可以使用 appends 方法增加搜索字串到分頁(yè)鏈接中：

<?php echo $users->appends(['sort' => 'votes'])->render(); ?>

這樣會(huì)產(chǎn)生類(lèi)似下列的鏈接：

http://example.com/something?page=2&sort=votes

如果您想要將「哈希片段」加到分頁(yè)的 URL，您可以使用 fragment 方法：

<?php echo $users->fragment('foo')->render(); ?>

此方法調(diào)用后將產(chǎn)生 URL，看起來(lái)像這樣：

http://example.com/something?page=2#foo

轉(zhuǎn)換至 JSON

Paginator 類(lèi)實(shí)現(xiàn) Illuminate\Contracts\Support\JsonableInterface 接口的 toJson 方法。由路由返回的值，您可能將 Paginator 實(shí)體傳換成 JSON。JSON 表單的實(shí)體會(huì)包含一些「元」信息，例如 total、current_page、last_page。該實(shí)體數(shù)據(jù)將可通過(guò)在                JSON 數(shù)組中 data 的鍵取得。