
本文介绍在 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 枚举值处理的首选实践。










