本教程深入探讨PHP 8.1及更高版本中枚举类型（Enum）的成员获取方法。我们将详细介绍如何利用cases()方法结合array_column函数，高效地提取枚举的所有成员名称和值，并提供一个可复用的EnumToArray Trait，以封装这些常用操作，从而提升代码的简洁性和可维护性。
PHP 8.1+ 枚举基础与 cases() 方法
php 8.1引入了对枚举（enums）的原生支持，为定义一组有限的、命名常量集合提供了更结构化和类型安全的方式。每个枚举成员都是一个unitenum实例。枚举类型提供了一个核心方法 cases()，它返回一个包含所有枚举成员实例的数组。
例如，定义一个简单的基本枚举：
enum Status{ case Active; case Inactive; case Pending;}
调用 Status::cases() 将返回 [Status::Active, Status::Inactive, Status::Pending]。
获取枚举成员名称
无论是基本枚举（Unit Enum）还是支持枚举（Backed Enum），都可以通过访问其name属性来获取成员的名称。结合cases()方法和array_column函数，可以轻松获取所有成员的名称数组。
enum Suit{ case Hearts; case Diamonds; case Clubs; case Spades;}// 获取所有枚举成员的名称$suitNames = array_column(Suit::cases(), 'name');print_r($suitNames);/* 输出:Array( [0] => Hearts [1] => Diamonds [2] => Clubs [3] => Spades)*/
获取支持枚举成员值 (Backed Enum Values)
支持枚举（Backed Enum）允许为每个成员关联一个标量值（字符串或整数）。对于这类枚举，除了名称外，我们还可以通过其value属性获取关联的值。
立即学习“PHP免费学习笔记（深入）”；
enum Color: string{ case Red = 'R'; case Green = 'G'; case Blue = 'B';}// 获取所有支持枚举成员的关联值$colorValues = array_column(Color::cases(), 'value');print_r($colorValues);/* 输出:Array( [0] => R [1] => G [2] => B)*/
构建可复用的 EnumToArray Trait
为了避免在每个枚举中重复编写获取名称和值的逻辑，我们可以创建一个Trait来封装这些常用操作。这个Trait将提供names()、values()和array()等静态方法，方便地获取枚举的各种表示形式。
以下是EnumToArray Trait的定义：
trait EnumToArray{ /** * 获取所有枚举成员的名称数组。 * 例如：['Hearts', 'Diamonds'] * * @return array */ public static function names(): array { return array_column(self::cases(), 'name'); } /** * 获取所有支持枚举成员的关联值数组。 * 仅适用于 Backed Enum。 * 例如：['H', 'D'] * * @return array */ public static function values(): array { // 检查当前枚举是否为 Backed Enum if (!is_subclass_of(self::class, BackedEnum::class)) { throw new BadMethodCallException(sprintf('The method %s::values() can only be called on Backed Enums.', self::class)); } return array_column(self::cases(), 'value'); } /** * 获取一个将关联值映射到名称的数组。 * 仅适用于 Backed Enum。 * 例如：['H' => 'Hearts', 'D' => 'Diamonds'] * * @return array */ public static function array(): array { // 检查当前枚举是否为 Backed Enum if (!is_subclass_of(self::class, BackedEnum::class)) { throw new BadMethodCallException(sprintf('The method %s::array() can only be called on Backed Enums.', self::class)); } return array_combine(self::values(), self::names()); }}
注意事项：
values()和array()方法中增加了运行时检查，确保它们只在支持枚举（Backed Enum）上调用，否则会抛出BadMethodCallException，提高了代码的健壮性。array()方法将value作为键，name作为值，生成一个映射数组。
在枚举中使用 EnumToArray Trait
要使用这个Trait，只需在你的枚举定义中引入它即可。
enum Suit: string{ use EnumToArray; // 引入 Trait case Hearts = 'H'; case Diamonds = 'D'; case Clubs = 'C'; case Spades = 'S';}// 使用 Trait 提供的方法$suitNames = Suit::names();$suitValues = Suit::values();$suitMap = Suit::array();echo "所有名称: n";print_r($suitNames);/* 输出:所有名称:Array( [0] => Hearts [1] => Diamonds [2] => Clubs [3] => Spades)*/echo "n所有值: n";print_r($suitValues);/* 输出:所有值:Array( [0] => H [1] => D [2] => C [3] => S)*/echo "n值到名称的映射: n";print_r($suitMap);/* 输出:值到名称的映射:Array( [H] => Hearts [D] => Diamonds [C] => Clubs [S] => Spades)*/
通过EnumToArray Trait，我们为枚举提供了一套标准化的接口，用于获取其成员的各种表示形式，极大地简化了代码并提高了可维护性。
总结与注意事项
cases() 方法核心： 它是获取所有枚举成员实例的入口，是所有进一步操作的基础。array_column 的灵活性： array_column 函数是处理cases()返回数组的关键，通过指定’name’或’value’作为第二个参数，可以高效地提取所需的数据。Trait 的优势： 使用Trait能够将通用的逻辑封装起来，避免代码重复，使得枚举定义更简洁，同时易于扩展和维护。区分基本枚举与支持枚举： 只有支持枚举（Backed Enum）才具有value属性。在使用values()或array()方法时，务必确保你的枚举是支持枚举类型，或者像示例Trait中那样加入类型检查以增强健壮性。PHP 版本要求： 本教程中介绍的枚举功能及cases()方法仅适用于 PHP 8.1 及更高版本。
掌握这些方法，将使你在PHP 8.1+项目中能够更高效、更优雅地处理枚举数据。
以上就是PHP 8.1+ 枚举：高效获取所有成员名称与值的实践指南的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1293949.html
微信扫一扫 
支付宝扫一扫 
