Laravel Nova 实现级联筛选器：制造商与型号的动态联动过滤-php教程-PHP中文网

laravel nova 实现级联筛选器：制造商与型号的动态联动过滤 - php中文网

本文介绍如何在 Laravel Nova 中实现两个 Select Filter 的级联联动，使“型号”筛选器能根据所选“制造商”动态更新可选项，解决多级依赖筛选场景下的用户体验与数据准确性问题。

在 Laravel Nova 中，默认的 Filter 类不支持跨过滤器状态通信，因此无法直接在 Model 过滤器的 options() 方法中读取 Manufacturer 过滤器当前选中的值——这也是原问题中 $request->input() 或尝试解码请求参数返回 null 的根本原因。官方 Nova 并未内置依赖式（Dependent）筛选逻辑，需借助社区扩展方案实现。

推荐使用开源库 awesome-nova/dependent-filter，它专为 Nova 设计，通过轻量级 Vue 组件 + 后端钩子，实现了过滤器间的响应式联动，无需修改 Nova 核心，兼容性好且易于集成。

✅ 安装与配置

首先通过 Composer 安装依赖：

Laravel

避免常见的Laravel错误：N+1查询、批量赋值、缓存陷阱及队列序列化陷阱。

下载

composer require awesome-nova/dependent-filter

发布前端资源（如使用 Nova v4+ 且启用 --no-publish 模式，请确认已运行 php artisan nova:publish --force）：

php artisan vendor:publish --provider="AwesomeNova\Providers\DependentFilterServiceProvider"

✅ 改造 Manufacturer 过滤器（父级）

继承 AwesomeNova\Filters\DependentFilter 替代原生 Filter，并定义唯一 attribute（作为依赖键名）：

<?php namespace App\Nova\Filters;

use Illuminate\Http\Request;
use App\Models\Product;
use AwesomeNova\Filters\DependentFilter;

class Manufacturer extends DependentFilter
{
    public $name = &#39;制造商&#39;;
    public $attribute = &#39;manufacturer&#39;; // ← 关键：此 key 将被 Model 过滤器引用
    public $component = &#39;awesome-nova-dependent-filter&#39;;

    public function apply(Request $request, $query, $value)
    {
        return $query->whereHas('product', fn ($q) => $q->where('manufacturer', $value));
    }

    public function options(Request $request, array $filters = [])
    {
        return Product::select('manufacturer')
            ->distinct()
            ->orderBy('manufacturer')
            ->pluck('manufacturer')
            ->mapWithKeys(fn ($m) => [$m => $m])
            ->toArray();
    }
}

? 注意：options() 方法签名已增强为 options(Request $request, array $filters = [])，虽本例未使用 $filters，但该参数是子过滤器获取父值的基础通道。

✅ 改造 Model 过滤器（子级，依赖 Manufacturer）

关键在于声明 public $dependentOf = ['manufacturer']，并利用 $filters['manufacturer'] 动态构建查询：

<?php namespace App\Nova\Filters;

use Illuminate\Http\Request;
use App\Models\Product;
use AwesomeNova\Filters\DependentFilter;

class Model extends DependentFilter
{
    public $name = &#39;型号&#39;;
    public $attribute = &#39;model&#39;;
    public $component = &#39;awesome-nova-dependent-filter&#39;;

    public $dependentOf = [&#39;manufacturer&#39;]; // ← 声明依赖关系
    public $hideWhenEmpty = true; // 当 manufacturer 未选时，自动隐藏本过滤器（可选）

    public function apply(Request $request, $query, $value)
    {
        return $query->whereHas('product', fn ($q) => $q->where('model', $value));
    }

    public function options(Request $request, array $filters = [])
    {
        // ✅ 此处 $filters['manufacturer'] 即前端选中的值（已由 JS 自动注入）
        $manufacturer = $filters['manufacturer'] ?? null;

        if (! $manufacturer) {
            return []; // 无制造商时返回空选项，配合 $hideWhenEmpty 更友好
        }

        return Product::select('model')
            ->where('manufacturer', $manufacturer)
            ->distinct()
            ->orderBy('model')
            ->pluck('model')
            ->mapWithKeys(fn ($m) => [$m => $m])
            ->toArray();
    }
}

✅ 在 Resource 中注册（注意使用 `::make()`）

// app/Nova/Review.php
public function filters(Request $request)
{
    return [
        Manufacturer::make(), // 必须调用 make() 以启用依赖注入
        Model::make(),
    ];
}

⚠️ 注意事项与最佳实践

字段一致性：确保 dependentOf 数组中的键（如 'manufacturer'）与父过滤器的 $attribute 完全一致（大小写、下划线等），否则依赖无法识别；
数据库性能：若 Product 表数据量大，建议为 (manufacturer, model) 字段添加联合索引：
```
ALTER TABLE products ADD INDEX idx_manufacturer_model (manufacturer, model);
```
空值处理：子过滤器 options() 中务必检查 $filters[$key] 是否存在，避免 SQL 错误；$hideWhenEmpty = true 可提升 UI 清洁度；
多级依赖：$dependentOf 支持数组，例如 ['category', 'brand']，options() 中可同时使用 $filters['category'] 和 $filters['brand'] 构建复合查询；
缓存优化（进阶）：对高频访问的选项列表，可在 options() 中加入 Laravel 缓存层，例如 Cache::remember("models_{$manufacturer}", 3600, fn () => ...)。