Laravel教程：高效筛选与展示基于数据库分类的数据-php教程-PHP中文网

Laravel教程：高效筛选与展示基于数据库分类的数据

本文将详细介绍在laravel中如何根据数据库中存储的分类列表，高效地筛选并展示产品数据。我们将探讨两种主要方法：利用eloquent的`wherehas`和`wherein`进行数据库层面的优化查询，以及使用集合的`filter`方法进行应用层面的数据处理，帮助开发者根据实际场景选择最合适的过滤策略。

在Laravel应用开发中，我们经常面临需要根据特定条件筛选数据并将其展示在视图（Blade）上的需求。一个常见的场景是，我们有一个产品列表，需要根据一个动态的、存储在数据库中的分类列表来筛选这些产品。例如，我们可能希望只显示属于“书籍”或“衬衫”类别的产品，而这些允许的类别名称本身也存储在另一个数据库表中。

为了实现这一目标，Laravel提供了多种强大且灵活的工具，主要包括Eloquent ORM的关系查询和集合操作。选择哪种方法取决于数据集的大小、性能要求以及过滤逻辑的复杂性。

准备工作：Eloquent模型与关系

为了充分利用Laravel的强大功能，建议为您的数据库表创建对应的Eloquent模型并定义好关系。

假设我们有以下两个表：

products 表：存储产品信息，包含 category_id 列。
categories 表：存储分类信息，包含 name 列。

对应的Eloquent模型和关系可能如下：

app/Models/Product.php

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Product extends Model
{
    use HasFactory;

    protected $fillable = ['name', 'description', 'category_id'];

    /**
     * 产品属于一个分类
     */
    public function category()
    {
        return $this->belongsTo(Category::class);
    }
}

登录后复制

app/Models/Category.php

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

class Category extends Model
{
    use HasFactory;

    protected $fillable = ['name'];

    /**
     * 一个分类可以有多个产品
     */
    public function products()
    {
        return $this->hasMany(Product::class);
    }
}

登录后复制

方法一：数据库层面的高效筛选（使用whereHas和whereIn）

这是处理大型数据集时推荐的方法，因为它在数据库层面完成筛选，只检索符合条件的数据，从而减少了从数据库到应用服务器的数据传输量和内存消耗。

核心原理：

首先从categories表获取我们想要筛选的产品类别名称列表。
使用Eloquent的whereHas方法来查询那些与特定分类存在关系的产品。
在whereHas的回调函数中，使用whereIn方法来指定关联分类的name字段必须在第一步获取的类别名称列表中。

实现示例：

假设我们希望筛选出categories表中所有名称为“Book”或“Shirt”的分类所对应的产品。

<?php

namespace App\Http\Controllers;

use App\Models\Product;
use App\Models\Category;
use Illuminate\Http\Request;

class ProductController extends Controller
{
    public function index(Request $request)
    {
        // 1. 从数据库中获取需要筛选的类别名称列表
        // 假设我们有一个categories表，其中包含我们希望匹配的特定类别。
        // 例如，我们可以从一个配置、另一个表或用户输入中获取这些类别。
        // 这里我们模拟从categories表中获取特定名称的类别
        $allowedCategoryNames = Category::whereIn('name', ['Book', 'Shirt'])->pluck('name')->toArray();

        // 确保类别列表不为空，避免whereIn传入空数组导致SQL错误或意外结果
        if (empty($allowedCategoryNames)) {
            $products = collect(); // 返回空集合
        } else {
            // 2. 使用whereHas和whereIn进行数据库层面的筛选
            $products = Product::whereHas('category', function ($query) use ($allowedCategoryNames) {
                $query->whereIn('name', $allowedCategoryNames);
            })->get();
        }

        // 3. 将筛选后的产品数据传递到Blade视图
        return view('products.index', compact('products'));
    }
}

登录后复制

代码解析：

芦笋演示

一键出成片的录屏演示软件，专为制作产品演示、教学课程和使用教程而设计。

查看详情

Category::whereIn('name', ['Book', 'Shirt'])->pluck('name')->toArray();：这行代码首先从categories表中查询出名称为“Book”或“Shirt”的分类记录，然后使用pluck('name')提取出这些分类的name字段值，并将其转换为一个PHP数组['Book', 'Shirt']。
Product::whereHas('category', function ($query) use ($allowedCategoryNames) { ... })：whereHas方法用于根据关联模型是否存在特定条件来筛选主模型。第一个参数'category'是Product模型中定义的关系名称。第二个参数是一个闭包，用于构建对关联模型（Category）的查询条件。
$query->whereIn('name', $allowedCategoryNames);：在闭包内部，我们对关联的Category模型应用whereIn条件，确保其name字段值在$allowedCategoryNames数组中。

优点：

性能优越： 筛选操作在数据库服务器上执行，只返回匹配的记录，减少了数据传输和内存占用。
可扩展性强： 适用于处理大量数据。
SQL优化： Laravel的Eloquent会自动生成优化的SQL查询。

方法二：应用层面的数据筛选（使用Collection::filter）

如果数据集相对较小，或者需要执行更复杂的、难以直接用SQL表达的过滤逻辑，可以使用Laravel集合的filter方法在应用层面进行筛选。

核心原理：

首先获取所有产品（或一个较大的产品子集）。
获取我们想要筛选的类别名称列表。
对产品集合使用filter方法，遍历每个产品，并在回调函数中判断其分类名称是否在允许的列表中。

实现示例：

<?php

namespace App\Http\Controllers;

use App\Models\Product;
use App\Models\Category;
use Illuminate\Http\Request;

class ProductController extends Controller
{
    public function index(Request $request)
    {
        // 1. 获取所有产品，并预加载分类关系以避免N+1问题
        $allProducts = Product::with('category')->get();

        // 2. 从数据库中获取需要筛选的类别名称列表
        $allowedCategoryNames = Category::whereIn('name', ['Book', 'Shirt'])->pluck('name')->toArray();

        // 3. 使用集合的filter方法进行应用层面的筛选
        $filteredProducts = $allProducts->filter(function (Product $product) use ($allowedCategoryNames) {
            // 确保产品有分类且分类名称在允许列表中
            return $product->category && in_array($product->category->name, $allowedCategoryNames);
        });

        // 如果需要，可以重置集合的键
        $products = $filteredProducts->values();

        // 4. 将筛选后的产品数据传递到Blade视图
        return view('products.index', compact('products'));
    }
}

登录后复制

代码解析：

Product::with('category')->get();：with('category')用于预加载产品的分类关系，避免在filter循环中产生N+1查询问题。get()获取所有产品并转换为一个Eloquent集合。
$allProducts->filter(function (Product $product) use ($allowedCategoryNames) { ... })：filter方法遍历集合中的每个元素，并对每个元素执行回调函数。如果回调函数返回true，则该元素保留在新集合中；否则被移除。
return $product->category && in_array($product->category->name, $allowedCategoryNames);：在回调函数中，我们检查当前产品的category关系是否存在（$product->category），并且其分类名称（$product->category->name）是否在$allowedCategoryNames数组中。
$filteredProducts->values();：filter方法会保留原始集合的键。如果希望结果集合的键从0开始重新索引，可以使用values()方法。

优点：

灵活性高： 适用于复杂的过滤逻辑，可以在回调函数中编写任何PHP代码。
适用于已加载数据： 如果数据已经加载到内存中，此方法无需再次查询数据库。

缺点：

性能开销： 对于大型数据集，首先加载所有数据到内存中，然后进行筛选，可能会导致较高的内存和CPU消耗。
N+1问题： 如果不使用with()预加载关系，在filter内部访问关联模型会导致N+1查询问题，严重影响性能。

在Blade视图中展示数据

无论您选择哪种筛选方法，最终都会得到一个包含筛选后产品数据的Eloquent集合。您可以在Blade视图中轻松地迭代并展示这些数据：

resources/views/products/index.blade.php

<h1>产品列表</h1>

@if($products->isEmpty())
    <p>没有找到匹配的产品。</p>
@else
    <ul>
        @foreach($products as $product)
            <li>
                <strong>{{ $product->name }}</strong>
                @if($product->category)
                    <small>({{ $product->category->name }})</small>
                @endif
                <p>{{ $product->description }}</p>
            </li>
        @endforeach
    </ul>
@endif

登录后复制

注意事项与最佳实践

优先使用数据库层面筛选： 对于绝大多数情况，尤其是在处理大量数据时，应优先考虑使用whereHas、where、whereIn等方法在数据库层面进行筛选。这能显著提高应用性能。
定义Eloquent关系： 确保您的模型之间建立了正确的Eloquent关系，这是高效使用whereHas的关键。
避免N+1问题： 如果必须在应用层面处理集合，并且需要访问关联模型数据，请务必使用with()方法进行预加载（eager loading），以避免N+1查询问题。
处理空筛选条件： 在将类别名称数组传递给whereIn或in_array之前，请检查该数组是否为空。如果为空，whereIn可能会导致SQL错误，或者返回所有记录（取决于数据库系统和Laravel版本），而in_array则会正常工作但不会匹配任何项。针对空数组情况，可以提前返回空集合或空查询结果。
分页处理： 如果筛选后的结果集仍然很大，考虑使用Laravel的分页功能（->paginate()）来限制每次加载到视图的数据量，进一步优化用户体验和性能。

总结

在Laravel中根据数据库中存储的分类列表筛选产品数据，我们有两种主要策略：利用Eloquent的whereHas和whereIn进行数据库层面的高效查询，以及使用集合的filter方法进行应用层面的灵活处理。对于性能敏感或大数据量的场景，强烈推荐前者；而对于小数据集或需要复杂PHP逻辑的场景，后者则提供了更高的灵活性。理解这两种方法的优缺点，并根据实际需求选择最合适的方案，是构建高效、可维护Laravel应用的关键。

以上就是Laravel教程：高效筛选与展示基于数据库分类的数据的详细内容，更多请关注php中文网其它相关文章！