PHP 8.3 升级需注意枚举相关变更：8.2 引入原生 enum，8.3 加强 JSON 序列化、类常量类型校验、参数类型约束及动态属性限制，旧模拟枚举代码易报错，须显式实现接口、补全类型声明、改用 from/tryFrom 转换并避免动态属性。
从 PHP 7.4 升级到 PHP 8.3，枚举类（enum）不是“自动可用”的新语法糖——它在 8.2 才首次引入，而 8.3 对其 JSON 序列化、类型约束和继承行为做了更严格的校验。项目里若已有模拟枚举的类常量或第三方库实现，升级后常会报错，但多数不是真崩溃，而是暴露了旧代码里长期被忽略的语义漏洞。
JSON序列化直接失败：Call to undefined method ::jsonSerialize()
PHP 8.2+ 的原生 enum 默认不实现 JsonSerializable，json_encode($status) 会抛出 Fatal error: Uncaught TypeError，而不是返回字符串值。
- 必须显式
implements JsonSerializable，并在jsonSerialize()中返回$this->value（标量枚举）或$this->name（纯枚举） - 不要依赖“自动转字符串”——这是常见误解；
echo $status能输出是因魔术方法__toString()，但json_encode()不调用它 - 若用的是
backed enum（如enum Status: string），仍需手动实现接口，不能省略
类常量重写冲突：Cannot use array as value for class constant
很多老项目用抽象类 + 类常量模拟枚举，例如：
abstract class OrderStatus { const PENDING = 'pending'; const COMPLETED = 'completed'; }
子类可能这样覆盖：class ApiStatus extends OrderStatus { const COMPLETED = []; —— 在 PHP 8.2 及以前能运行，8.3 直接报 Fatal error。
立即学习“PHP免费学习笔记（深入）”；
- 这不是枚举本身的错，而是类常量类型校验变严：父类未声明类型，子类赋值类型不一致即拒绝加载
- 解决路径只有两个：全部改用原生
enum；或给所有模拟枚举的类常量补全类型，如const string COMPLETED = 'completed'; - 注意 trait 中的常量同样受此规则约束，容易遗漏
类型不匹配导致调用中断：Argument #1 ($status) must be of type OrderStatus, string given
旧代码常把枚举值当字符串传参：process($data['status'])，其中 $data['status'] 是从 JSON 解析来的 'pending' 字符串，但函数签名已改成 function process(OrderStatus $status)。
- PHP 8.3 不再隐式转换；必须显式构造：
OrderStatus::from($data['status'])（适用于 backed enum）或OrderStatus::tryFrom($data['status'])（安全容错版） - 若用的是纯 enum（无 backing type），只能靠
match或array_search手动映射，没有内置转换方法 - 建议在 API 入口层统一做转换，避免业务逻辑里散落大量
tryFrom调用
动态属性干扰：Deprecated: Creation of dynamic property OrderStatus::$label
有些模拟枚举的类会动态加属性用于展示，比如：$status->label = '待处理';。PHP 8.3 默认禁止该操作，触发弃用警告。
- 原生
enum是 final 且不可实例化为对象，无法加属性；这种需求应改用普通类或带方法的枚举 - 若坚持用类模拟，需加
#[AllowDynamicProperties]注解，但不推荐——这违背枚举“固定值集合”的本意 - 更合理做法：在枚举中定义方法，如
public function label(): string { return match($this) { self::PENDING => '待处理', ... }; }
