Laravel中如何在Crud接口类中传入自定义请求？

我在为CRUD操作创建Interface类时，遇到了方法声明不兼容的错误。具体场景如下：

定义的CrudInterface接口 #

文件路径：app/Repositories/Interfaces/CrudInterface.php

<?php

use Illuminate\Foundation\Http\FormRequest;

interface CrudInterface
{
    public function store(array $data, FormRequest $request): Model;
    // 其他方法...
}

TagCrudRepository实现类 #

文件路径：app/Repositories/TagCrudRepository.php

<?php
namespace App\Repositories;

use App\Http\Requests\CreateTagRequest;
use App\Repositories\Interfaces\CrudInterface;
use Illuminate\Database\Eloquent\Model;
// 其他引入...

class TagCrudRepository implements CrudInterface
{
    public function store(array $data, CreateTagRequest $request): Tag
    {
        // 业务逻辑...
    }
    // 其他方法实现...
}

错误提示 #

Declaration of App\Repositories\TagCrudRepository::store(array $data, App\Http\Requests\CreateTagRequest $request): App\Models\Tag must be compatible with App\Repositories\Interfaces\CrudInterface::store(array $data, Illuminate\Foundation\Http\FormRequest $request): Illuminate\Database\Eloquent\Model

补充说明 #

CreateTagRequest继承自FormRequest：

namespace App\Http\Requests;
use Illuminate\Foundation\Http\FormRequest;

class CreateTagRequest extends FormRequest
{
    // 请求验证逻辑...
}

修复方案 #

问题根源是PHP的方法参数逆变规则：接口定义的参数类型是父类FormRequest，实现类不能用其子类CreateTagRequest作为参数（参数类型只能更宽泛或与接口一致）；而返回值用Tag（Model的子类）是符合协变规则的，这部分没问题。

方案一：修改实现类参数类型，内部做校验 #

将实现类的参数类型改为FormRequest，在方法内部验证请求类型是否符合预期：

public function store(array $data, FormRequest $request): Tag
{
    // 确保传入的是CreateTagRequest实例
    if (!$request instanceof CreateTagRequest) {
        throw new \InvalidArgumentException('必须传入CreateTagRequest类型的请求');
    }
    
    // 后续业务逻辑...
}

方案二：使用泛型接口（推荐类型安全） #

修改CrudInterface为泛型接口，让每个实现类可以绑定自己的请求和模型类型：

<?php
namespace App\Repositories\Interfaces;

use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Database\Eloquent\Model;

interface CrudInterface
{
    /**
     * @template TRequest of FormRequest
     * @template TModel of Model
     * @param array $data
     * @param TRequest $request
     * @return TModel
     */
    public function store(array $data, FormRequest $request): Model;
}

然后在实现类中通过PHPDoc明确类型（配合PHPStan/Psalm等静态分析工具，保证类型安全）：

/**
 * @param array $data
 * @param CreateTagRequest $request
 * @return Tag
 */
public function store(array $data, CreateTagRequest $request): Tag
{
    // 业务逻辑...
}

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