17370845950

PHP 8.4 尚未发布，当前最新稳定版是 PHP 8.3；枚举（enum）自 PHP 8.1 起引入，仅支持 string 和 int 底层类型，需显式声明且 case 值类型必须严格匹配。

PHP 8.4 并不存在——PHP 官方尚未发布 8.4 版本，当前最新稳定版是 PHP 8.3（截至 2025 年中），而枚举（enum）早在 PHP 8.1 就已正式引入。如果你看到“PHP 8.4 enum”相关内容，大概率是误传、笔误，或混淆了其他语言（如 TypeScript）的版本号。

PHP 枚举从 8.1 开始可用，无需等待 8.4

PHP 的 enum 是标量枚举（scalar enums），仅支持 string 和 int 底层类型，不支持类方法体、构造函数或属性初始化（除非用 case 关联值）。它不是“增强版 class”，而是轻量级、类型安全的常量集合。

• enum 必须显式声明底层类型：enum Status: string 或 enum Priority: int
• 每个 case 必须带值（case Draft = 'draft';）或由引擎自动递增（case Low = 1; 后续 case Medium; → 值为 2）
• 不能继承，不能被继承，不可实例化（new Status() 报错）
• 支持 match 表达式直接解构：match($status) { Status::Draft => '草稿中', ... }

定义与使用常见错误：值类型不匹配

最常踩的坑是底层类型和 case 值类型不一致，导致解析失败或静默截断：

enum Role: string
{
    case Admin = 'admin';
    case Editor = 'editor';
    // ❌ 错误：下面这行会报 Fatal error
    case Guest = 0;
}

上面代码在 PHP 8.1+ 直接报 Fatal error: Uncaught ValueError: Enum case Guest has incompatible type。同理，enum Code: int 中写 case NotFound = '404'; 也会失败。

• 确认所有 case 值类型与枚举声明的底层类型严格一致
• 字符串枚举推荐全小写 + 下划线，整数枚举建议显式赋值（避免依赖自动递增顺序）
• 若需混合语义（如带描述的枚举），用 static function 配合 match 模拟（PHP 不支持关联数组式 case）

如何在运行时获取枚举所有 case 和值

PHP 枚举不提供内置的 values() 或 cases() 方法（PHP 8.3 仍未加入），但可通过反射安全提取：

$cases = array_map(
    fn(\UnitEnum $case) => $case->value,
    Status::cases()
);

注意：Status::cases() 是 PHP 8.2+ 才引入的静态方法；PHP 8.1 中必须用反射：

$reflection = new \ReflectionEnum(Status::class);
$cases = array_map(
    fn(\ReflectionEnumUnitCase $case) => $case->getValue(),
    $reflection->getCases()
);

• Status::cases() 只在 PHP ≥ 8.2 可用，8.1 用户必须用反射
• getCases() 返回的是 ReflectionEnumUnitCase 对象，需调用 getValue() 获取真实值
• 别试图用 getConstants() —— 枚举不是 class，ReflectionClass 不适用

真正要注意的是：别被“8.4”误导，先检查 php -v 输出；如果项目还在用 8.0 或更低，升级到 8.1+ 才能用 enum。另外，Laravel 等框架对枚举的支持（如模型 cast、迁移字段映射）往往滞后于核心，需单独验证兼容性。