Laravel多页面复用联系人搜索表单填充问题问询

嘿，我正好碰到过类似的场景，给你几个实用的方案，帮你快速搞定这个复用表单的数据填充问题：

方案一：用视图Composer共享数据（适合多页面复用） #

因为你的表单要在多个页面使用，最省心的方式是通过视图Composer把需要的唯一值数据自动共享给这个表单视图，不用在每个控制器里重复写查询代码。

步骤1：在AppServiceProvider里注册视图Composer #

打开app/Providers/AppServiceProvider.php，在boot()方法里添加以下代码：

use App\Models\User;
use Illuminate\Support\Facades\View;
use Illuminate\Support\Facades\Cache;

public function boot()
{
    // 给你的联系人搜索表单视图共享数据
    View::composer('partials.contact-search', function ($view) {
        // 用缓存优化性能（可选，数据不频繁更新的话非常推荐）
        $departments = Cache::remember('unique_departments', 3600, function () {
            return User::distinct()->pluck('department')->filter();
        });
        
        $roles = Cache::remember('unique_roles', 3600, function () {
            return User::distinct()->pluck('role')->filter();
        });
        
        $locations = Cache::remember('unique_locations', 3600, function () {
            return User::distinct()->pluck('location')->filter();
        });

        $view->with(compact('departments', 'roles', 'locations'));
    });
}

这里用filter()是为了过滤掉数据库里为空的字段值，避免下拉框出现空选项；Cache::remember则是把查询结果缓存1小时，减少数据库压力。

步骤2：编写你的Blade Include组件 #

假设你的表单视图放在resources/views/partials/contact-search.blade.php，内容如下：

<form action="{{ route('contacts.search') }}" method="GET">
    <!-- 部门选择框 -->
    <div class="mb-3">
        <label for="department" class="form-label">部门</label>
        <select name="department" id="department" class="form-select">
            <option value="">全部部门</option>
            @foreach($departments as $dept)
                <option value="{{ $dept }}" {{ request('department') === $dept ? 'selected' : '' }}>
                    {{ $dept }}
                </option>
            @endforeach
        </select>
    </div>

    <!-- 职位选择框 -->
    <div class="mb-3">
        <label for="role" class="form-label">职位</label>
        <select name="role" id="role" class="form-select">
            <option value="">全部职位</option>
            @foreach($roles as $role)
                <option value="{{ $role }}" {{ request('role') === $role ? 'selected' : '' }}>
                    {{ $role }}
                </option>
            @endforeach
        </select>
    </div>

    <!-- 地点选择框 -->
    <div class="mb-3">
        <label for="location" class="form-label">地点</label>
        <select name="location" id="location" class="form-select">
            <option value="">全部地点</option>
            @foreach($locations as $loc)
                <option value="{{ $loc }}" {{ request('location') === $loc ? 'selected' : '' }}>
                    {{ $loc }}
                </option>
            @endforeach
        </select>
    </div>

    <button type="submit" class="btn btn-primary">搜索联系人</button>
</form>

这里的request('字段名') === 值是为了在搜索后保留用户的选择状态，提升体验。

步骤3：在任意页面复用表单 #

现在你只需要在需要的页面里加上这句代码，就能直接使用带数据的表单了：

@include('partials.contact-search')

方案二：用Laravel组件类（更结构化的方式） #

如果你的项目用的是Laravel 8+，推荐用官方的组件系统，让代码更模块化：

步骤1：生成组件 #

执行Artisan命令生成组件：

php artisan make:component ContactSearch

步骤2：完善组件类 #

打开app/View/Components/ContactSearch.php，修改成这样：

namespace App\View\Components;

use App\Models\User;
use Illuminate\View\Component;
use Illuminate\Support\Facades\Cache;

class ContactSearch extends Component
{
    public $departments;
    public $roles;
    public $locations;

    public function __construct()
    {
        // 同样用缓存优化
        $this->departments = Cache::remember('unique_departments', 3600, function () {
            return User::distinct()->pluck('department')->filter();
        });
        
        $this->roles = Cache::remember('unique_roles', 3600, function () {
            return User::distinct()->pluck('role')->filter();
        });
        
        $this->locations = Cache::remember('unique_locations', 3600, function () {
            return User::distinct()->pluck('location')->filter();
        });
    }

    public function render()
    {
        return view('components.contact-search');
    }
}

步骤3：编写组件视图 #

修改resources/views/components/contact-search.blade.php，内容和方案一的表单代码一致即可。

步骤4：使用组件 #

在页面里直接用标签调用：

<x-contact-search />

额外小贴士 #

• 如果你的Users表数据量很大，除了缓存，还可以考虑定时任务预生成这些唯一值的缓存，或者把这些值存在专门的配置表/缓存里，进一步提升性能。
• 如果需要支持动态搜索（比如用户输入时实时过滤选项），可以在前端用JavaScript实现，或者结合Livewire做无刷新交互，但这属于进阶需求了。

内容的提问来源于stack exchange，提问作者Jesse Luke Orange