Laravel项目中App\Enums\IssueStatus类未找到问题求助

一、修复Enum类的基础问题 #

1. 修正PHP起始标签 #

你的IssueStatus Enum文件开头使用了短标签<?，这在部分环境下可能被禁用，还会导致PHPStan无法正确识别该文件。将开头替换为标准PHP起始标签：

<?php
namespace App\Enums;

/**
 * Enum class representing the issue status
 *
 * @package App\Enums
 */
enum IssueStatus: int
{
    case NEW = 0;
    case IN_PROGRESS = 1;
    case ON_HOLD = 2;
    case RESOLVED = 3;        
}

2. 确认文件路径与命名空间匹配 #

确保Enum文件的路径为app/Enums/IssueStatus.php，遵循Laravel的PSR-4自动加载规范：App\Enums\IssueStatus命名空间必须对应app/Enums/IssueStatus.php文件，注意Linux系统下文件名大小写敏感，避免出现大小写不匹配的情况。

二、修正SQL查询中Enum的使用方式 #

在模型查询作用域中，直接使用IssueStatus::RESOLVED传递的是枚举实例，而数据库存储的是枚举对应的int值，需要显式获取枚举的底层值：

public static function scopeNotResolved()
{
    return self::join('shop', 'issues.shop_id', '=', 'shop.id')
        ->select('issues.*', 'shop.shop_name')
        ->where('issues.status', '!=', IssueStatus::RESOLVED->value)
        ->orderBy('issues.status', 'asc')->get();
}

三、修复PHPStan的识别问题 #

完成以上步骤后如果PHPStan仍报错，执行以下操作：

• 运行composer dump-autoload，重新生成自动加载文件，确保Laravel和PHPStan能识别到新的Enum类。
• 检查PHPStan配置文件（如phpstan.neon），确认App\Enums命名空间被包含在扫描范围内，默认Laravel项目的PHPStan配置会覆盖app目录，一般无需额外配置，若有自定义配置需确保未排除该目录。

额外优化：模型字段自动转换Enum #

为了让模型更优雅处理Enum字段，可在Issue模型中定义$casts属性，将status字段自动转换为Enum实例：

class Issue extends Model
{
    use HasFactory;

    protected $table = 'issues';
    protected $fillable = [
        'shop_id', 
        'title', 
        'description',
        'status'
    ];

    // 自动转换status字段为Enum实例
    protected $casts = [
        'status' => IssueStatus::class,
    ];

    // ... 其他代码
}

这样获取模型status属性时会自动得到IssueStatus实例，赋值时可直接传入枚举实例或对应int值，Laravel会自动处理转换。

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