php8.4如何使用枚举类型_php8.4enum定义与使用教程【介绍】

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、迁移字段映射）往往滞后于核心，需单独验证兼容性。

# php # laravel # php8 # typescript # Static # String # 常量 # 关联数组 # 构造函数 # Error # 枚举类型 # enum # 字符串 # int # 继承 # class # 值类型 # function # 对象 # 的是 # 不支持 # 会报 # 稳定版 # 如果你 # 也会 # 相关内容 # 还在 # 下划线 # 要注意

返回目录在线咨询

上一篇： ,北京唐山城际高铁从哪订票？
下一篇：腾讯云服务器如何快速搭建个人网站？

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

全网整合营销服务商

php8.4如何使用枚举类型_php8.4enum定义与使用教程【介绍】

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

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

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

您的项目需求