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

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'; 也会失败。
立即学习“PHP免费学习笔记(深入)”;
- 确认所有
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、迁移字段映射)往往滞后于核心,需单独验证兼容性。











