Laravel 11中如何为多控制器创建带不同参数的通用接口？

核心问题分析 #

你之前的操作失效原因如下：

• 直接将接口参数定义为FormRequest：Laravel的依赖注入会解析基础FormRequest实例，而非你自定义的子类，导致子类的验证规则无法触发。
• 手动判断请求类型/强制类型转换：绕开了Laravel的请求解析流程，自定义请求的验证逻辑是在DI解析阶段自动执行的，手动转换不会触发验证。
• 仅用PHPDoc注释：这只是文档提示，不影响PHP类型系统和Laravel的DI机制，无法让框架注入正确的请求子类。

可行解决方案 #

方案一：PHP泛型实现（PHP 8.1+ 推荐） #

利用PHP泛型让接口支持不同类型的自定义FormRequest，同时满足类型约束。

1. 定义带泛型的通用接口

<?php

namespace App\Contracts;

use Illuminate\Foundation\Http\FormRequest;

interface CrudControllerInterface
{
    /**
     * @template T of FormRequest
     * @param T $request
     * @return \Illuminate\Http\JsonResponse
     */
    public function store(FormRequest $request);
}

2. 控制器实现时指定具体请求类

<?php

namespace App\Http\Controllers\Api;

use App\Contracts\CrudControllerInterface;
use App\Http\Requests\StoreUserRequest;
use Illuminate\Http\JsonResponse;
use App\Models\User;

class UserController implements CrudControllerInterface
{
    public function store(StoreUserRequest $request): JsonResponse
    {
        // 此时$request已通过StoreUserRequest的验证
        $user = User::create($request->validated());
        return response()->json($user, 201);
    }
}

方案二：基类请求+接口继承（兼容低版本PHP） #

通过定义基础请求类，让所有自定义请求继承它，再用基类作为接口参数类型。

1. 创建基础请求类

<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;

abstract class BaseFormRequest extends FormRequest
{
    // 可添加通用验证逻辑或方法
}

2. 自定义请求继承基类

<?php

namespace App\Http\Requests;

class StoreUserRequest extends BaseFormRequest
{
    public function rules(): array
    {
        return [
            'name' => 'required|string|max:255',
            'email' => 'required|email|unique:users',
            // 其他验证规则
        ];
    }
}

3. 通用接口使用基类作为参数

<?php

namespace App\Contracts;

use App\Http\Requests\BaseFormRequest;
use Illuminate\Http\JsonResponse;

interface CrudControllerInterface
{
    public function store(BaseFormRequest $request): JsonResponse;
}

4. 控制器实现时直接用具体请求类

<?php

namespace App\Http\Controllers\Api;

use App\Contracts\CrudControllerInterface;
use App\Http\Requests\StoreUserRequest;
use Illuminate\Http\JsonResponse;
use App\Models\User;

class UserController implements CrudControllerInterface
{
    public function store(StoreUserRequest $request): JsonResponse
    {
        $user = User::create($request->validated());
        return response()->json($user, 201);
    }
}

内容的提问来源于stack exchange，提问作者Simon_Paul_99