Larastan在Resource文件调用relationLoaded方法时报错怎么解决？

核心原因 #

Larastan作为静态分析工具，无法识别JsonResource通过魔术方法代理到Eloquent模型的relationLoaded方法——虽然运行时代码能正常执行，但静态分析阶段会判定方法不存在。

具体解决方法 #

方法一：直接调用模型实例的方法

JsonResource的$this->resource属性才是被包装的Eloquent模型实例，修改代码为：

'mediaProp'=>$this->when($this->resource->relationLoaded('mediaProp'), new MediaPropResource($this->mediaProp)),

直接调用模型实例的relationLoaded，Larastan能直接识别到该方法属于Eloquent模型，不会再报错。

方法二：添加PHPDoc注释声明模型类型

在PostResource类上方添加注释，明确资源对象代理的模型类：

<?php

namespace App\Http\Resources;

use Illuminate\Http\Resources\Json\JsonResource;
use App\Models\Post; // 替换为你的实际Post模型类路径

/**
 * @mixin Post
 */
class PostResource extends JsonResource
{
    public function toArray($request)
    {
        $data = [
            'id' => $this->id,
            // ... 其他字段
            'mediaProp'=>$this->when($this->relationLoaded('mediaProp'), new MediaPropResource($this->mediaProp)),
        ];
        // ... 其他逻辑
    }
}

通过@mixin注释告诉Larastan，该资源类代理了Post模型的所有方法，包括relationLoaded。

方法三：调整Larastan配置并清理缓存

你不需要将PostResource添加到universalObjectCratesClasses，因为父类JsonResource已经在配置中。修改phpstan.neon配置：

parameters:
    universalObjectCratesClasses:
        - Illuminate\Http\Resources\Json\JsonResource
    # 其他配置不变

然后运行命令清理Larastan缓存：

php artisan larastan:clear

重新执行Larastan分析即可。

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