如何高效提取 PHP 枚举(Enum)的所有底层值

7次阅读

如何高效提取 PHP 枚举(Enum)的所有底层值

本文介绍在 php 8.1+ 中,如何从标量枚举(如 `enum type: int`)中快速提取所有关联的原始值(如 `1, 2, 3`),并展示 `array_column()` 的多种实用用法,涵盖值列表、名称映射、双向查找等场景。

PHP 自 8.1 起引入了原生枚举(Enum),尤其当定义为标量枚举(如 enum Type: int)时,每个枚举成员都绑定一个明确的底层值。虽然 Type::cases() 可以获取全部枚举实例数组,但若仅需底层值(如 1, 2, 3),还需进一步提取。最直观的方式是遍历并访问 ->value 属性:

$values = []; foreach (Type::cases() as $case) {     $values[] = $case->value; } // 结果:[1, 2, 3]

不过,php 内置的 array_column() 函数为此类操作提供了更简洁、高效的替代方案。它能直接从对象数组中按属性名批量提取值:

$values = array_column(Type::cases(), 'value'); // ✅ 输出:[1, 2, 3]

array_column() 的强大之处在于其灵活性——通过第三个参数可指定键名,从而构建各类映射关系。以下为常见实用模式:

  • 仅值列表(索引数组):

    立即学习PHP免费学习笔记(深入)”;

    $values = array_column(Type::cases(), 'value'); // [1, 2, 3]
  • 仅名称列表

    $names = array_column(Type::cases(), 'name'); // ['OFFENSIVE', 'SPAM', 'IRRELEVANT']
  • 名称 → 值 映射(关联数组

    $map = array_column(Type::cases(), 'value', 'name'); // ['OFFENSIVE' => 1, 'SPAM' => 2, 'IRRELEVANT' => 3]
  • 值 → 名称 映射(反向查找)

    $reverseMap = array_column(Type::cases(), 'name', 'value'); // [1 => 'OFFENSIVE', 2 => 'SPAM', 3 => 'IRRELEVANT']
  • 名称 → 枚举实例 / 值 → 枚举实例(便于运行时反射或工厂调用):

    $byName = array_column(Type::cases(), null, 'name');   // ['OFFENSIVE' => Type::OFFENSIVE, ...] $byValue = array_column(Type::cases(), null, 'value'); // [1 => Type::OFFENSIVE, ...]

⚠️ 注意事项:

  • array_column() 要求传入的是「可索引数组」,而 ::cases() 返回的正是标准数组,完全兼容;
  • 所有示例均适用于 int 或 String 标量枚举,不适用于纯对象枚举(即无标量类型的 enum);
  • 若需类型安全的值提取(如强制整型),可在 array_column 后链式调用 array_map(‘intval’, …),但通常无需——因 ->value 已是声明类型(如 int);
  • 避免手动 foreach + []= 拼接,array_column 更简洁、性能更优且语义清晰。

综上,array_column(Type::cases(), ‘value’) 是获取枚举底层值的标准推荐方式,兼具可读性、健壮性与扩展性,应作为 PHP 枚举值处理的首选实践。

text=ZqhQzanResources