当前位置：首页 > news >正文

php8 枚举使用教程

news 2025/5/6 8:43:53

简介

PHP 从 8.1 开始原生支持枚举（enum），这是 PHP 向类型安全和现代语言特性迈进的重要一步。枚举可以定义一组有穷的、不可变的常量集合，常用于表示状态值、选项类型等。

基础语法

PHP 支持两种类型的枚举：

纯枚举（Pure Enum）

纯枚举没有绑定值，仅代表自身：

enum Status {case Draft;case Published;case Archived;
}

使用：

$status = Status::Published;if ($status === Status::Draft) {echo '草稿';
}

具名枚举 / 带值枚举（Backed Enum）

带有标量值（string 或 int），可用于数据库或 API 等场景。

enum Role: string {case Admin = 'admin';case User = 'user';case Guest = 'guest';
}

使用：

$role = Role::Admin;echo $role->value; // 输出 'admin'

反查：

$role = Role::from('user');  // Role::User
$role = Role::tryFrom('unknown'); // null（安全版）

枚举常用方法和特性

->name：获取枚举名（如 'Admin'）
>value：获取值（仅限 Backed Enum）
::cases()：返回所有枚举项数组
::from($value)：根据值获取枚举，找不到报错
::tryFrom($value)：根据值获取枚举，找不到返回 null

示例：

foreach (Role::cases() as $role) {echo $role->name . ' => ' . $role->value . PHP_EOL;
}

枚举 vs 常量类

比较点	常量类	枚举
类型安全	❌ 无类型检查	✅ 类型安全
IDE 智能提示	一般	更好
可迭代性	❌	✅ `::cases()`
反向查找	❌ 手动维护	✅ `from()、tryFrom()`
可扩展性	低	✅ 支持方法、trait、接口等

枚举中添加方法

enum Status: string {case Draft = 'draft';case Published = 'published';case Archived = 'archived';public function label(): string {return match($this) {self::Draft => '草稿',self::Published => '已发布',self::Archived => '已归档',};}
}

与属性注解结合

结合 PHP 8 的属性，可以为枚举项注解：

use Attribute;#[Attribute]
class Label {public function __construct(public string $text) {}
}enum Status {#[Label('草稿')]case Draft;#[Label('发布')]case Published;#[Label('归档')]case Archived;
}

读取方式：

$ref = new ReflectionEnumUnitCase(Status::class, 'Draft');
$attrs = $ref->getAttributes(Label::class);
$label = $attrs[0]->newInstance()->text;echo $label; // 草稿