如何在PHPStan中为实现的泛型接口指定类型？

问题根源 #

Laravel的CastsAttributes是泛型接口，包含TGet（模型属性的读取类型）和TSet（数据库存储的写入类型）两个模板参数。PHPStan级别6+会强制要求实现该接口的类必须显式指定这两个参数的具体类型，否则会抛出泛型未指定的错误。

解决方案 #

根据你的需求（数据库存二进制UUID，模型属性强制用UuidInterface），按以下步骤修改代码：

1. 显式指定泛型参数
   在自定义Cast类实现CastsAttributes时，明确声明TGet为Ramsey\Uuid\UuidInterface（模型读取时的类型），TSet为string（数据库存储的二进制字符串类型）：

   use Illuminate\Contracts\Database\Eloquent\CastsAttributes;
   use Ramsey\Uuid\UuidInterface;
   use Ramsey\Uuid\Uuid;
   
   class Uuid implements CastsAttributes<UuidInterface, string>
   {
       /**
        * 从数据库二进制转换为UuidInterface
        */
       public function get($model, string $key, $value, array $attributes): UuidInterface
       {
           return Uuid::fromBytes($value);
       }
   
       /**
        * 将UuidInterface转换为二进制字符串存入数据库
        */
       public function set($model, string $key, $value, array $attributes): string
       {
           if (!$value instanceof UuidInterface) {
               throw new \InvalidArgumentException('属性值必须是UuidInterface实例');
           }
           return $value->getBytes();
       }
   }
   

2. 模型中声明属性类型
   在使用该Cast的模型里，给对应属性加上类型提示，帮助PHPStan准确推断类型：

   use Illuminate\Database\Eloquent\Model;
   use Ramsey\Uuid\UuidInterface;
   
   class YourModel extends Model
   {
       protected $casts = [
           'uuid_column' => Uuid::class,
       ];
   
       public UuidInterface $uuid_column;
   }
   

3. 确保PHPStan识别泛型
   如果使用larastan（Laravel官方PHPStan扩展），它已内置Laravel泛型接口的类型定义，无需额外配置；纯PHPStan环境下，Laravel源码自带的泛型注释会被自动识别。

关键说明 #

• TGet对应get()方法的返回类型，即模型中访问属性时的类型
• TSet对应set()方法的返回类型，即存入数据库的类型
• 显式指定泛型后，PHPStan能严格校验属性的读写类型，避免类型不匹配的错误

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