Laravel模型如何正确声明请求计算属性？解决Larastan报错

1. 修正访问器命名规则 #

Laravel模型的访问器必须遵循get{AttributeName}Attribute的命名规范，其中AttributeName是字段名的驼峰形式。你当前的访问器命名不符合规范，导致无法关联查询返回的banner_clicked_counts_count字段。

修改BannerCategory模型中的访问器：

// 替换原有的getBannerClickedCountsCount方法
public function getBannerClickedCountsCountAttribute(): int
{
    // 从模型attributes数组获取查询结果，默认0避免null
    return (int) $this->attributes['banner_clicked_counts_count'] ?? 0;
}

2. 移除不必要的自定义属性与setter #

你手动定义的protected $bannerClickedCountsCount = 0和setBannerClickedCountsCount方法完全多余——Laravel会自动将查询结果存入模型的$attributes数组，无需手动维护类属性。删除以下代码：

// 移除这部分代码
protected $bannerClickedCountsCount = 0;

function setBannerClickedCountsCount(int $bannerClickedCountsCount)
{
    \Log::info(varDump($bannerClickedCountsCount, ' -1 setBannerClickedCountsCount $bannerClickedCountsCount::'));
    return $this->bannerClickedCountsCount = $bannerClickedCountsCount;
}

3. 确认$appends配置正确 #

保持$appends中的属性名为驼峰形式（对应访问器的属性名）：

protected $appends = ['bannerClickedCountsCount'];

调整后，你既可以用蛇形$bannerCategory->banner_clicked_counts_count，也可以用驼峰$bannerCategory->bannerClickedCountsCount访问该值，两种方式都会触发访问器返回正确的查询结果。

4. 消除Larastan的未定义属性报错 #

在模型类上添加PHPDoc注释，明确声明该属性的存在：

/**
 * @property-read int $banner_clicked_counts_count
 * @property-read int $bannerClickedCountsCount
 */
class BannerCategory extends Model
{
    // ... 模型原有代码
}

问题根源说明 #

• 访问器命名错误：Laravel无法将查询的banner_clicked_counts_count字段与你的getBannerClickedCountsCount方法关联，导致访问器未被触发。
• 自定义属性未被赋值：你定义的$bannerClickedCountsCount是类的protected属性，Laravel不会自动把查询结果赋值给它，所以始终返回初始值0。

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