如何在 Laravel 验证请求（FormRequest）中动态传入控制器参数

本文介绍在 laravel 中如何从控制器向自定义验证请求类（formrequest）安全传递运行时参数（如 `new => true`），解决服务分层架构下验证逻辑需感知“新增/更新”上下文的常见需求。

在 Laravel 的分层设计实践中，将业务逻辑拆分为 Controller → Validation Request → Service 是推荐做法。但默认情况下，FormRequest 仅绑定 HTTP 请求数据（$request->all()、$request->input() 等），无法直接访问控制器中动态附加的变量——这正是你遇到的核心问题。

你尝试使用 $request->add(['new' => true])，但该方法并不存在于 Laravel 的 Illuminate\Http\Request 或 FormRequest 类中（Laravel 9+ 已移除 add() 方法）。正确且推荐的方式是使用 merge() 方法：

public function store(AlbumRequest $request, AlbumService $service)
{
    // ✅ 正确：使用 merge() 向请求实例注入运行时参数
    $request = $request->merge(['new' => true]);

    try {
        $service->store($request);
        return redirect()->route('admin.web.album.index');
    } catch (\Exception $err) {
        return back()->withInput()->with('error', $err->getMessage());
    }
}

⚠️ 注意：merge() 返回一个新请求实例，因此必须重新赋值给 $request 变量（不可忽略返回值）。

在 AlbumRequest 中，即可通过标准方式访问该参数：

class AlbumRequest extends FormRequest
{
    public function rules()
    {
        // ✅ 可直接使用 input()、get() 或 request() 辅助函数
        $isNew = $this->input('new', false); // 第二个参数为默认值

        return $isNew
            ? [
                'title' => 'required|string|max:255',
                'cover_image' => 'required|image|mimes:jpg,jpeg,png|max:2048',
              ]
            : [
                'title' => 'required|string|max:255',
                'cover_image' => 'nullable|image|mimes:jpg,jpeg,png|max:2048',
              ];
    }

    // ✅ 也可在 authorize() 或 withValidator() 中使用
    public function withValidator($validator)
    {
        if ($this->input('new')) {
            $validator->after(function ($validator) {
                // 新增场景下的额外校验逻辑
                if (Album::where('slug', $this->input('slug'))->exists()) {
                    $validator->errors()->add('slug', 'Slug 已存在，请更换。');
                }
            });
        }
    }
}

✅ 最佳实践建议：

• 避免在 rules() 中使用 dd() 调试，它会中断请求生命周期；改用 Log::debug() 或 dump()（开发环境）；
• 若参数语义明确（如区分新增/更新），更清晰的做法是定义两个独立的 Request 类（StoreAlbumRequest / UpdateAlbumRequest），提升可读性与可维护性；
• 对于复杂判断逻辑，可将上下文提取为方法，例如 isCreating()，增强复用性：

public function isCreating(): bool
{
    return (bool) $this->input('new');
}

综上，$request->merge([...]) 是 Laravel 官方支持、线程安全且符合框架设计哲学的解决方案，能无缝融入你的服务分层架构，让验证层真正“感知业务意图”。