本文详细介绍了在 Laravel 8 中，如何根据数据库中预定义的类别列表来筛选并显示产品数据。我们将探讨两种主要方法：利用 Eloquent 关系和 whereHas 进行数据库层面的高效过滤，以及使用 Laravel Collection 的 filter 方法进行内存中的数据筛选。文章将提供详细的代码示例、使用场景分析以及最佳实践建议，帮助开发者构建灵活高效的数据展示功能。
引言
在 Web 应用开发中，根据特定条件筛选数据是常见的需求。例如，在一个电商平台中，我们可能需要根据用户选择的商品类别来展示产品。本教程将聚焦于一个具体场景：我们有一个 products 表存储商品信息，其中包含一个 category 字段；同时，我们有一个 categories 表，它定义了一组允许显示的商品类别。我们的目标是只在 Blade 视图中展示那些类别匹配 categories 表中定义的商品。
数据模型与初始设置
为了充分利用 Laravel 的强大功能，我们强烈建议使用 Eloquent 模型来管理数据库交互，并定义模型之间的关系。
假设我们有以下两个表和对应的 Eloquent 模型：
-
products 表:
- id
- name
- category_id (外键，关联到 categories 表的 id)
- ...
-
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>注意事项与最佳实践
- 优先使用 Eloquent whereHas: 对于涉及数据库关系的筛选，始终优先考虑使用 whereHas 或其他 Eloquent/DB 查询构建器方法，因为它们在数据库层面执行，效率最高。
- 避免 N+1 查询: 当你需要访问关联模型的数据时（例如 $product->category->name），务必使用 with() 方法进行预加载，以避免每次循环都触发新的数据库查询。
- 数据结构: 确保你的 categories 表（或任何用于定义允许列表的表）的数据结构清晰，能够方便地提取出用于筛选的条件。如果类别名称存储在 JSON 字段中，你需要先解析 JSON。
- 空列表处理: 在控制器中，考虑当 $allowedCategoryNames 列表为空时如何处理。是返回空产品列表，还是返回所有产品，这取决于你的业务逻辑。
- 缓存: 如果允许的类别列表不经常变化，可以考虑对其进行缓存，以减少数据库查询次数。
总结
本文详细介绍了在 Laravel 8 中根据数据库定义的类别列表筛选产品并在 Blade 视图中展示的两种主要方法。对于大多数场景，利用 Eloquent 的 whereHas 方法进行数据库层面的高效筛选是最佳选择。而 Collection 的 filter 方法则适用于小数据集或需要复杂内存筛选逻辑的特定情况。通过遵循本文的指导和最佳实践，你可以构建出高效、可维护且功能强大的数据筛选功能。
