PHP BackedEnum::from 与 tryFrom 怎么选择

BackedEnum::from() 与 tryFrom() 的选择，关键不在写法长短，而在“找不到枚举值是不是异常”。如果输入按系统不变量必须有效，用 from()，让无效值立即抛出 ValueError；如果输入来自用户、文件或外部系统，无效值属于可预期分支，用 tryFrom()，再对 null 做明确校验。

PHP 官方文档：https://www.php.net/manual/en/backedenum.from.php

先看最核心的返回契约

Backed Enum 由 string 或 int 标量支撑。每个 case 的 backing value 必须唯一，实例上的 value 属性只读。from() 和 tryFrom() 都负责把标量映射回枚举实例，只有“不匹配”时的语义不同。

两种方法的签名也直接表达了差异：from(int|string): static 保证正常返回时一定得到枚举实例；tryFrom(int|string): ?static 要求调用者处理可空结果。

可信内部状态为什么更适合 from

假设数据库中的 articles.status 只能保存当前枚举定义的值，并且迁移、写入和约束都由本系统管理。那么读到 archived 不是普通用户输入错误，而是数据、部署版本或约束已经不一致。此时使用 from() 能让问题立即暴露。

不要为了“防止报错”把这里改成 tryFrom() ?? ArticleStatus::Draft。那会把损坏数据悄悄解释为草稿，后续可能触发错误的权限、发布或计费逻辑。内部异常应该在统一异常层记录上下文并报警，而不是伪装成一个合法业务状态。

外部输入为什么更适合 tryFrom

HTTP 参数、CSV 字段、消息队列载荷和第三方 API 都可能出现未知值。它们不一定代表程序故障，而是边界校验的一部分。tryFrom() 让应用自行决定返回 422、收集导入错误或拒绝消息，而不是让 ValueError 穿过业务层。

这里的 null 只是“没有对应 case”，不是验证已经完成。调用者仍要决定错误文案、HTTP 状态码、导入行号和是否允许重试。枚举只负责值域映射，不负责完整的接口错误协议。

null 不是默认正确值

tryFrom($value) ?? $default 很方便，但只能在业务确实定义了默认值时使用。例如筛选条件为空时默认“全部”可能合理，而支付状态、权限角色、库存状态遇到未知值时自动降级，往往会掩盖数据问题。

不要把 TypeError 与未匹配混在一起

官方文档指出，这两个方法遵循 PHP 的弱类型与严格类型规则。在 strict_types=1 下，把整数传给 string-backed enum，或把字符串传给 int-backed enum，会抛出 TypeError；浮点数在严格模式下同样会触发 TypeError。因此 tryFrom() 只把“类型正确但值不在枚举中”变成 null。

在弱类型模式中，PHP 可能按通常规则进行标量转换，这会让字符串数字等输入看起来“可以工作”。对于接口和领域模型，建议在文件顶部启用严格类型，并在进入枚举前完成格式清洗；这样值不匹配和类型不匹配的含义更清楚。

采用建议：按边界统一，而不是逐行随意选择

团队可以把规则写成一句话：领域内部转换默认使用 from()，系统边界解析默认使用 tryFrom() 加显式校验。这样代码评审看到 tryFrom() ?? 默认值 时，会主动确认业务是否真的允许默认；看到外部输入直接调用 from() 时，也会检查异常是否已被正确映射。

如果需要在多处解析同一种外部输入，可以在枚举或专门的解析器旁封装一个命名清楚的方法，例如 parseRequestValue()，统一错误对象和允许值提示。不要在 Backed Enum 中重新声明名为 from() 或 tryFrom() 的方法，PHP 会把这种定义视为致命错误。

常见问题

tryFrom 会捕获 TypeError 吗？

不会。它只在标量类型符合要求但没有匹配 case 时返回 null。参数类型错误仍会抛出 TypeError。

数据库字段一定要用 from 吗？

不一定。若数据库是外部系统、旧库或允许脏数据，应把它当不可信边界，用 tryFrom 收集并处理错误；只有本系统真正维护其不变量时，from 才更合适。

能不能对所有 tryFrom 结果使用默认值？

不能。默认值必须来自明确业务规则，否则会把未知状态伪装成合法状态。安全、权限、支付和库存相关枚举尤其不应静默降级。

纯枚举可以使用 from 和 tryFrom 吗？

不可以。这两个方法属于 BackedEnum，只适用于带 string 或 int backing value 的枚举；纯枚举可通过 cases() 获取 case 列表。