Laravel 过滤器获取分页不过滤附加到分页链接 - PHP

当我们在 Laravel 中使用分页时，经常需要使用筛选器来获取数据。然而，有时我们希望能够过滤数据但不过滤附加到分页链接中的参数。在这篇文章中，我们将探讨如何通过 Laravel 的筛选器来实现这一功能。

Laravel 分页筛选器

Laravel 分页筛选器是一个非常有用的功能，可以轻松地获取数据并在分页页面上展示它们。在 Laravel 中，分页功能由 paginate() 方法提供。下面是一个简单的例子，演示如何使用 paginate() 方法来获取数据并在分页页面上展示它们：

public function index()
{
    $users = DB::table('users')->paginate(10);

    return view('users', ['users' => $users]);
}

在上面的例子中，我们从 users 表中获取了一组用户，并将它们分页到每页 10 个用户。然后，我们将这个分页对象传递给视图文件，以便展示数据。

分页时过滤参数

有时候，我们需要除了分页参数之外，还需要一些额外的参数。例如，在 users 页面上展示用户，并提供一些筛选选项，例如性别、年龄等等。那么，我们就需要将这些筛选选项添加到分页链接中，以便我们可以轻松地筛选数据。

然而，如果我们简单地将这些筛选选项添加到 URL 中，我们可能会遇到一个问题：在分页时，筛选选项也会被过滤掉，从而导致我们无法正确地筛选数据。例如，在 users 页面上展示男性用户，并将它们分页到每页 10 个用户。我们可以使用以下链接：

<a href="/users?gender=male&page=1">Display Male Users</a>

然而，当我们点击页面的“下一页”链接时，我们会发现，当前页面的筛选选项已经丢失了，不再正确地显示男性用户。

如何解决这个问题呢？我们可以创建一个自定义的筛选器，该筛选器可以过滤分页数据，但不会过滤分页链接中的参数。

创建自定义过滤器

首先，我们需要创建一个自定义过滤器。在 Laravel 中，筛选器是一个函数，该函数接受与查询器相同的参数，并返回一个查询生成器实例。下面是一个简单的例子，演示如何创建一个过滤器：

function genderFilter($query, $gender)
{
    if ($gender) {
        $query->where('gender', '=', $gender);
    }

    return $query;
}

在上面的例子中，我们定义了一个名为 genderFilter 的过滤器。该过滤器接受一个 $query 参数和一个 $gender 参数。如果 $gender 参数被设置为一个值，我们将在查询中使用 where() 方法添加一个匹配条件。最后，我们返回查询生成器实例。

接下来，我们需要将这个自定义的过滤器注册到 Laravel 中。我们可以将过滤器注册到 Laravel 的查询生成器中，以便我们在所有的查询中使用它们。下面是一个简单的例子，演示如何注册过滤器：

use Illuminate\Support\Facades\DB;

DB::listen(function ($query) {
    $query->sql;
    $bindings = $query->bindings;
    $time = $query->time;
});

DB::listen(function ($query) {
    if ($query->time > 100) {
        Log::warning('Slow query:', [
            'sql' => $query->sql,
            'bindings' => $query->bindings,
            'time' => $query->time,
        ]);
    }
});

在上面的例子中，我们使用 DB::listen() 方法在查询生成器中注册了两个过滤器。每当查询生成器被执行时，这些过滤器都会被调用。在第一个过滤器中，我们仅仅记录了查询的 SQL 语句、绑定值以及执行时间。在第二个过滤器中，我们检查了查询的执行时间，如果执行时间超过了 100 毫秒，就使用 Log 类记录一条警告信息。

过滤分页数据

现在，我们已经创建了自定义的过滤器并将其注册到了 Laravel 中，接下来我们需要使用这个过滤器来获取分页数据。我们可以使用 Laravel 提供的 paginate() 方法来获取分页数据，并使用自定义的过滤器进行过滤。下面是一个简单的例子，演示我们如何将自定义的过滤器应用到分页对象中：

public function index(Request $request)
{
    $gender = $request->input('gender');

    $users = DB::table('users')
        ->when($gender, function ($query, $gender) {
            return genderFilter($query, $gender);
        })
        ->paginate(10);

    return view('users', ['users' => $users]);
}

在上面的例子中，我们首先获取了 $gender 参数。然后，我们使用 when() 方法来检查 $gender 是否被设置。如果 $gender 被设置，我们将使用 genderFilter() 方法来对数据进行过滤。最后，我们使用 paginate() 方法获取分页数据，并将分页对象传递给视图文件。

不过滤分页链接中的参数

最后，我们需要将 gender 参数添加到分页链接中，以便我们可以轻松地筛选数据。然而，我们也不能忘记，在分页时，我们需要保留这些参数，以便它们在下一页和上一页中都能正常工作。

为了实现这一点，我们需要使用 Laravel 提供的 appends() 方法。该方法可以将额外的参数添加到分页链接中，并确保它们在下一页和上一页中保持不变。下面是一个简单的例子，演示如何使用 appends() 方法来添加参数到分页链接中：

{{ $users->appends(['gender' => request('gender')])->links() }}

在上面的例子中，我们使用 appends() 方法将 gender 参数添加到分页链接中。我们还使用 request() 函数来获取 $gender 参数的值，并将其传递给 appends() 方法。最后，我们使用 links() 方法来生成分页链接。

结论

在这篇文章中，我们讨论了如何使用 Laravel 的自定义筛选器来获取分页数据。我们还讨论了如何确保筛选器不会过滤分页链接中的额外参数。现在你可以使用这些技巧来构建更强大的分页系统，并为你的用户提供更好的筛选和浏览体验。