Laravel8如何按类别筛选产品

本文深入探讨了在 Laravel 8 中实现产品数据按类别筛选的有效方法，旨在帮助开发者构建灵活高效的数据展示功能。文章重点介绍了两种核心策略：一是利用 Eloquent 关系和 `whereHas` 在数据库层面进行高性能过滤，尤其适用于处理大型数据集；二是运用 Laravel Collection 的 `filter` 方法，在内存中进行数据筛选，更适合小规模数据或需要复杂逻辑的场景。通过详细的代码示例、使用场景分析和最佳实践建议，本文旨在帮助读者掌握 Laravel 8 中数据过滤的关键技术，从而优化 Web 应用的数据处理能力和用户体验。掌握**Laravel 8 数据过滤**，轻松实现**产品类别筛选**，提升**电商平台**用户体验。

本文详细介绍了在 Laravel 8 中，如何根据数据库中预定义的类别列表来筛选并显示产品数据。我们将探讨两种主要方法：利用 Eloquent 关系和 whereHas 进行数据库层面的高效过滤，以及使用 Laravel Collection 的 filter 方法进行内存中的数据筛选。文章将提供详细的代码示例、使用场景分析以及最佳实践建议，帮助开发者构建灵活高效的数据展示功能。

引言

在 Web 应用开发中，根据特定条件筛选数据是常见的需求。例如，在一个电商平台中，我们可能需要根据用户选择的商品类别来展示产品。本教程将聚焦于一个具体场景：我们有一个 products 表存储商品信息，其中包含一个 category 字段；同时，我们有一个 categories 表，它定义了一组允许显示的商品类别。我们的目标是只在 Blade 视图中展示那些类别匹配 categories 表中定义的商品。

数据模型与初始设置

为了充分利用 Laravel 的强大功能，我们强烈建议使用 Eloquent 模型来管理数据库交互，并定义模型之间的关系。

假设我们有以下两个表和对应的 Eloquent 模型：

1. products 表:

   • id
   • name
   • category_id (外键，关联到 categories 表的 id)
   • ...

2. categories 表:

   • id
   • name (例如: 'Book', 'Shirt')
   • ...

相应的 Eloquent 模型 (Product.php 和 Category.php) 应定义关系：

// app/Models/Product.php
namespace App\Models;

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

class Product extends Model
{
    use HasFactory;

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

    /**
     * Get the category that owns the product.
     */
    public function category()
    {
        return $this->belongsTo(Category::class);
    }
}

// app/Models/Category.php
namespace App\Models;

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

class Category extends Model
{
    use HasFactory;

    protected $fillable = ['name'];

    /**
     * Get the products for the category.
     */
    public function products()
    {
        return $this->hasMany(Product::class);
    }
}

获取允许的类别列表

在进行产品筛选之前，我们需要从 categories 表中获取一个允许的类别名称列表。

// 在你的控制器中
use App\Models\Category;

public function index($subdomain)
{
    // 从 categories 表中获取所有允许的类别名称
    // 假设 categories 表的 'name' 列存储了 'Book', 'Shirt' 等类别名称
    $allowedCategoryNames = Category::pluck('name')->toArray();

    // ... 后续筛选逻辑
}

现在，$allowedCategoryNames 变量将包含一个数组，例如 ['Book', 'Shirt']。

筛选产品的方法

我们将介绍两种主要的筛选方法：一种是利用 Eloquent 的关系查询在数据库层面进行筛选（推荐），另一种是获取所有数据后在 PHP 内存中进行筛选。

方法一：使用 Eloquent whereHas 进行数据库层面筛选 (推荐)

这种方法利用了 Eloquent 的 whereHas 函数，它允许我们基于关联模型的条件来筛选主模型。这是处理大量数据时最高效的方法，因为筛选操作直接在数据库中完成。

// app/Http/Controllers/ProductController.php
<?php

namespace App\Http\Controllers;

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

class ProductController extends Controller
{
    public function index($subdomain)
    {
        // 1. 获取允许的类别名称列表
        $allowedCategoryNames = Category::pluck('name')->toArray();

        // 2. 使用 whereHas 筛选产品
        // 仅当 allowedCategoryNames 不为空时才应用筛选
        if (!empty($allowedCategoryNames)) {
            $products = Product::query()->whereHas('category', function ($query) use ($allowedCategoryNames) {
                $query->whereIn('name', $allowedCategoryNames);
            })->get();
        } else {
            // 如果没有允许的类别，则不返回任何产品或根据业务逻辑返回所有产品
            $products = collect(); // 返回空集合
            // 或者 $products = Product::all(); // 返回所有产品
        }

        return view('products.index', compact('products', 'allowedCategoryNames'));
    }
}

代码解释：

• Product::query(): 开始一个 Eloquent 查询构建器。
• whereHas('category', function ($query) use ($allowedCategoryNames) { ... }): 这是一个关键函数。它会检查 Product 模型是否有一个关联的 category，并且这个关联的 category 满足内部闭包中的条件。
  • 'category'：指的是 Product 模型中定义的 category() 关系方法。
  • function ($query) use ($allowedCategoryNames)：闭包接收一个查询构建器实例 $query，这个 $query 作用于关联的 categories 表。use ($allowedCategoryNames) 确保 $allowedCategoryNames 变量在闭包内部可用。
  • $query->whereIn('name', $allowedCategoryNames)：这会在 categories 表中查找 name 字段值在 $allowedCategoryNames 数组中的记录。只有当产品关联的类别名称匹配这个条件时，该产品才会被包含在结果集中。
• ->get(): 执行查询并返回匹配的 Product 模型集合。

优点：

• 高效性: 筛选逻辑在数据库层面执行，只检索符合条件的数据，减少了从数据库传输到应用的数据量。
• 可扩展性: 适用于大型数据集，性能表现优异。
• 简洁性: 代码逻辑清晰，易于理解和维护。

方法二：使用 Collection filter 进行内存中筛选

如果你的数据集相对较小，或者你已经出于其他原因加载了所有产品数据，并且需要在 PHP 内存中进行更复杂的筛选逻辑，那么可以使用 Laravel Collection 的 filter 方法。

// app/Http/Controllers/ProductController.php
<?php

namespace App\Http\Controllers;

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

class ProductController extends Controller
{
    public function index($subdomain)
    {
        // 1. 获取允许的类别名称列表
        $allowedCategoryNames = Category::pluck('name')->toArray();

        // 2. 获取所有产品 (注意：这会加载所有产品到内存)
        // 为了避免 N+1 查询问题，建议使用 with('category') 预加载关系
        $allProducts = Product::with('category')->get();

        // 3. 使用 Collection 的 filter 方法筛选产品
        $products = $allProducts->filter(function (Product $product) use ($allowedCategoryNames) {
            // 确保产品有关联的类别，并且该类别的名称在允许列表中
            return $product->category && in_array($product->category->name, $allowedCategoryNames);
        });

        return view('products.index', compact('products', 'allowedCategoryNames'));
    }
}

代码解释：

• Product::with('category')->get(): 首先从数据库中获取所有产品。with('category') 用于预加载 category 关系，以避免在 filter 循环中产生 N+1 查询问题。
• $allProducts->filter(function (Product $product) use ($allowedCategoryNames) { ... }): 对 $allProducts 集合应用 filter 方法。闭包会对集合中的每个 Product 对象执行。
  • return $product->category && in_array($product->category->name, $allowedCategoryNames);: 对于每个产品，检查它是否有关联的类别 ($product->category)，并且该类别的名称 ($product->category->name) 是否存在于 $allowedCategoryNames 数组中。如果两个条件都满足，则该产品会被保留在结果集合中。

优点：

• 灵活性: 可以在 PHP 内存中执行任何复杂的筛选逻辑。
• 方便性: 如果数据量不大且已经加载到内存中，此方法非常直接。

缺点：

• 性能问题: 对于大型数据集，首先加载所有产品到内存，然后进行筛选，效率远低于数据库层面的筛选。这可能导致内存消耗过大和响应时间变长。
• N+1 查询: 如果不使用 with('category') 预加载关系，每次访问 $product->category 都会触发一个新的数据库查询，导致严重的性能问题。

在 Blade 视图中展示数据

无论你选择哪种筛选方法，最终 $products 变量都将是一个包含符合条件产品的 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
            </li>
        @endforeach
    </ul>
@endif

<h2>允许的类别:</h2>
<ul>
    @foreach ($allowedCategoryNames as $categoryName)
        <li>{{ $categoryName }}</li>
    @endforeach
</ul>

注意事项与最佳实践

1. 优先使用 Eloquent whereHas: 对于涉及数据库关系的筛选，始终优先考虑使用 whereHas 或其他 Eloquent/DB 查询构建器方法，因为它们在数据库层面执行，效率最高。
2. 避免 N+1 查询: 当你需要访问关联模型的数据时（例如 $product->category->name），务必使用 with() 方法进行预加载，以避免每次循环都触发新的数据库查询。
3. 数据结构: 确保你的 categories 表（或任何用于定义允许列表的表）的数据结构清晰，能够方便地提取出用于筛选的条件。如果类别名称存储在 JSON 字段中，你需要先解析 JSON。
4. 空列表处理: 在控制器中，考虑当 $allowedCategoryNames 列表为空时如何处理。是返回空产品列表，还是返回所有产品，这取决于你的业务逻辑。
5. 缓存: 如果允许的类别列表不经常变化，可以考虑对其进行缓存，以减少数据库查询次数。

总结

本文详细介绍了在 Laravel 8 中根据数据库定义的类别列表筛选产品并在 Blade 视图中展示的两种主要方法。对于大多数场景，利用 Eloquent 的 whereHas 方法进行数据库层面的高效筛选是最佳选择。而 Collection 的 filter 方法则适用于小数据集或需要复杂内存筛选逻辑的特定情况。通过遵循本文的指导和最佳实践，你可以构建出高效、可维护且功能强大的数据筛选功能。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。