PHP 8.3 枚举是类型系统升级关键，纯枚举无底层值，背衬枚举支持 value 和 JSON 序列化；match 必须穷尽所有 case，枚举不可动态添加属性，元数据需静态映射。
PHP 8.3 的枚举不是“语法糖”，而是类型系统升级的关键一环——它能直接堵住字符串常量泛滥、拼写错误、运行时状态校验等高频漏洞。用对了，函数参数、数据库字段映射、API 响应结构都能更稳；用错了，比如当成普通字符串硬转，反而会触发 TypeError 或覆盖掉预期行为。
纯枚举 vs 背衬枚举：选错类型会导致 JSON 序列化失败
纯枚举（enum Status { case PENDING; }）不带底层值，$status->value 会报错；背衬枚举（enum Status: string { case PENDING = 'pending'; }）才支持 ->value 和 JSON 直出。
- API 返回 JSON 时，必须用背衬枚举，否则
json_encode()输出的是对象而非字符串值 - 数据库存状态字段（如 MySQL
VARCHAR），推荐背衬枚举，方便OrderStatus::PENDING->value直接入库 - 仅用于内部逻辑分发（如
match分支）、不对外暴露值的场景，纯枚举内存更省、语义更纯粹 - PHP 8.3 中，背衬枚举的
->value是只读属性，不能赋值；试图$e->value = 'xxx'会抛Error
match 表达式必须穷尽所有 case，漏写会触发 Fatal Error
PHP 8.3 不再容忍未覆盖的枚举分支，match 必须显式列出全部 case，或加 default（但加 default 会削弱类型安全，不推荐）。
- 新增一个
case ARCHIVED后，所有已有match必须同步补上对应分支，否则运行时报Fatal error: Unhandled match expression value - IDE（如 PHPStorm）在 PHP 8.3 模式下能实时标出遗漏分支，但 CLI 运行时不会警告，只崩溃
- 若需兼容未来扩展，可用
match($e) { ... } catch (UnhandledMatchError $e)包裹，但应视为临时兜底，非长期方案
枚举方法里不能访问 $this->name 以外的动态属性
枚举是轻量单例对象，没有传统类的属性空间。定义时写的 public string $label 是非法的，PHP 8.3 会直接 Parse Error。
立即学习“PHP免费学习笔记（深入）”；
- 想附加元数据（比如中文描述），只能通过静态方法或关联数组映射：
private const LABELS = [self::PENDING => '待处理']; -
$e->name始终存在且只读，返回定义时的标识符名（如'PENDING'），大小写敏感 - 动态属性（如
$e->extra = true）在 PHP 8.3 中已被弃用，枚举实例上尝试设置会触发Deprecated: Creation of dynamic property - 需要复杂行为？考虑封装为 Value Object，把枚举当构造参数传入，而不是往枚举里塞逻辑
真正难的不是写对第一个 enum，而是让整个代码链路（数据库迁移、API 输入验证、前端枚举同步、测试覆盖率配置）都跟上枚举的约束力。比如 php-code-coverage 8.3 要求显式标注 #[CodeCoverageIgnore] 才能跳过某个 case 的覆盖率统计，否则缺一个就报红——这恰恰说明，枚举不是可选装饰，而是契约本身。
