当前位置：首页 > 文章列表 > 文章 > php教程 > PHP8.4枚举类型详解与使用方法

PHP8.4枚举类型详解与使用方法

2026-01-26 17:09:42 0浏览收藏

“纵有疾风来，人生不言弃”，这句话送给正在学习文章的朋友们，也希望在阅读本文《PHP8.4枚举类型使用教程》后，能够真的帮助到大家。我也会在后续的文章中，陆续更新文章相关的技术文章，有好的建议欢迎大家在评论留言，非常感谢！

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

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

PHP 8.4 并不存在——PHP 官方尚未发布 8.4 版本，当前最新稳定版是 PHP 8.3（截至 2024 年中），而枚举（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()
);