Laravel項目中偽靜態分頁處理的示例分析

這篇文章給大家分享的是有關Laravel項目中偽靜態分頁處理的示例分析的內容。小編覺得挺實用的，因此分享給大家做個參考，一起跟隨小編過來看看吧。

下面由Laravel教程欄目給大家介紹Laravel 項目 偽靜態分頁處理  ,希望對需要的朋友有所幫助！

手上有個 Laravel 的項目，要求做偽靜態處理，項目中使用了 Laravel 自帶的分頁組件，分頁組件分頁會在你的 URL 用 Query 的方式做頁碼的傳遞，達不到偽靜態的要求。

想要的效果

我們偽靜態想要的效果大體是這樣的:

 /software/3dmax/created_at/page-1.html

對應 Laravel 的路由是:

/software/{category}/{order}/page-{page}.html

因為 Laravel 路由本身是支持路由參數的，所以說 我們變量的獲取是完全沒有問題的，但是 Laravel 自帶的分頁組件會將你的 參數 用 Query 的方式做傳遞，所以生成的分頁地址是下面這種

 /software/3dmax/created_at/page-1.html?category=3dmax&order=created_at&page=2

這不是我們需要的，所以我們需要對 Laravel 自帶的分頁組件進行修改。

Laravel 分頁組件

在 Laravel 中我們如果需要分頁，會調用 模型中的 paginate 方法，然后傳遞每頁的頁碼。

• paginate 方法會調用 Illuminate\Database\Concerns\BuildsQueries 下的paginator方法。

• paginator 方法會構造一個 Illuminate\Pagination\LengthAwarePaginator的實例。

• Illuminate\Pagination\LengthAwarePaginator 會使用 Illuminate\Pagination\AbstractPaginator 中的url方法進行構造請求參數和url。

現在我們找到生成 URL 的地方了，我們需要做的就是在這里修改。

重寫分頁組件

Laravel 中本身支持自定義分頁組件，But 我們做的不是自定義分頁，我們需要對于方法進行重寫。

創建 LengthAwarePaginator 類

mkdir app/Pagination
touch app/Pagination/LengthAwarePaginator.php

文件 app/Pagination/LengthAwarePaginator.php 內容：

<?php

namespace App\Pagination;

use Illuminate\Support\Arr;
use Illuminate\Support\Str;
use Illuminate\Pagination\LengthAwarePaginator as BasePaginator;

class LengthAwarePaginator extends BasePaginator
{
}

重寫 Url 方法

首先 Laravel 自帶的分頁 會把路由里面的參數放到 Query中，我們需要的是 參數還是放到地址中。

• 獲取到所有的 query 參數

• 判斷需要分頁的頁面路由中是否有綁定的路由參數

• 如果沒有的話，我們就走 Laravel 本身的分頁

• 如果有的話，我們就通過路由和路由參數進行構建地址，并把它從 query 參數中剔除

• 判斷下當前的 query 參數中是否還有參數，如果還有的話，我們就和之前一樣。

修改 app/Pagination/LengthAwarePaginator.php下內容：

...

public function url($page)
    {
        if ($page <= 0) {
            $page = 1;
        }

        $parameters = [$this->pageName => $page];

        if (count($this->query) > 0) {
            $parameters = array_merge($this->query, $parameters);
        }

        //判斷的參數是否在 路由中 需要綁定的數據
        $params = \request()->route()->parameters();

        if (!empty($params)) {
            foreach ($parameters as $key => $parameter) {
                if (isset($params[$key])) {
                    $params[$key] = $parameter;
                    unset($parameters[$key]);
                }
            }

            $path = route(\request()->route()->getAction('as'), $params);
        } else {
            $path = $this->path;
        }

        // 判斷是否有參數
        if (empty(Arr::query($parameters))) {
            return $path . $this->buildFragment();
        }

        return $path
            . (Str::contains($this->path, '?') ? '&' : '?')
            . Arr::query($parameters)
            . $this->buildFragment();
    }

    ...

使用自定義的分頁組件

在 Laravel 中我們如果需要分頁，會調用 模型中的 paginate 方法，但是paginate方法的定義在Illuminate\Database\Eloquent\Builder下，如果我們需要重寫的話，會很麻煩，并且還有一個問題就是，并不是我們所有的分頁都是需要偽靜態的，比如我們用戶中心的數據可能不太需要偽靜態。所以我們需要一個可以手動設置的東西，Larave 模型中有一個 本地作用域，我們可以寫一個方法staticPaginate，當需要使用靜態分頁的時候，我們可以Model->query()->staticPaginate(); 來調用，所需要的參數和 Laravel 自帶的 pageinage 方法類似。

公共的Model 基類文件

Laravel項目中的 Model 我們一般不會直接繼承Illuminate\Database\Eloquent\Model 我們一般都在 app\Models 目錄定義一個 Model  基類，所有的模型都繼承自 Model 基類，這并不是必須的，只是這樣的話對于模型修改，或添加公共的方法比較方便。

在模型中定義本地作用域

你只需要拷貝 Illuminate\Database\Eloquent\Builder下的paginate方法的內容并修改$this的指向就可以了

...

use Illuminate\Pagination\Paginator;
# Laravel 自帶的。
use Illuminate\Contracts\Pagination\LengthAwarePaginator;

...

   /**
     * 自定義靜態分頁
     * @author kingofzihua
     * @param Builder $builder
     * @param int $perPage
     * @param array $columns
     * @param string $pageName
     * @param int|null $page
     * @return LengthAwarePaginator
     *
     * @throws \InvalidArgumentException
     */
    public function scopeStaticPaginate($builder, $perPage = null, $columns = ['*'], $pageName = 'page', $page = null)
    {
        if (request('page')) {
            request()->offsetSet('page', request('page'));
        }

        $page = $page ?: Paginator::resolveCurrentPage($pageName);

        $perPage = $perPage ?: $builder->getModel()->getPerPage();

        $results = ($total = $builder->toBase()->getCountForPagination())
            ? $builder->forPage($page, $perPage)->get($columns)
            : $builder->getModel()->newCollection();
        return $this->paginator($results, $total, $perPage, $page, [
            'path' => Paginator::resolveCurrentPath(),
            'pageName' => $pageName,
        ]);
    }

    ...

替換自定義的分頁組件

# 替換
use App\Pagination\LengthAwarePaginator;
# --- use  Illuminate\Contracts\Pagination\LengthAwarePaginator;  // 注釋

...

   /**
     *
     * @param \Illuminate\Support\Collection $items
     * @param int $total
     * @param int $perPage
     * @param int $currentPage
     * @param array $options
     * @return LengthAwarePaginator
     */
    protected function paginator($items, $total, $perPage, $currentPage, $options)
    {
        return Container::getInstance()->makeWith(LengthAwarePaginator::class, compact(
            'items', 'total', 'perPage', 'currentPage', 'options'
        ));
    }

    ...

在項目中使用靜態分頁組件

Model::query()->staticPaginate($pageSize);

感謝各位的閱讀！關于“Laravel項目中偽靜態分頁處理的示例分析”這篇文章就分享到這里了，希望以上內容可以對大家有一定的幫助，讓大家可以學到更多知識，如果覺得文章不錯，可以把它分享出去讓更多的人看到吧！