PHP枚举值获取：全面指南与实用技巧-php教程-PHP中文网

PHP枚举值获取：全面指南与实用技巧

心靈之曲

发布： 2025-09-05 17:45:18

原创

378人浏览过

PHP枚举值获取：全面指南与实用技巧

本文详细介绍了在PHP 8.1及更高版本中如何高效地获取枚举（Enum）的所有成员名称和关联值。通过Enum::cases()方法结合array_column，以及引入一个可复用的EnumToArray特性，本教程将帮助开发者以结构化且优雅的方式管理和访问枚举数据，提升代码的可读性和维护性。

PHP枚举基础与值获取

php 8.1引入了对枚举（enums）的原生支持，为定义一组有限的、命名常量提供了强大的类型安全机制。在实际开发中，我们经常需要获取枚举的所有成员，无论是其名称（例如hearts）还是其关联的原始值（例如h）。

获取所有枚举成员

所有枚举类型都提供了一个静态方法 cases()，它返回一个包含所有枚举实例的数组。这是获取枚举所有成员的基础。

enum Suit
{
    case Hearts;
    case Diamonds;
    case Clubs;
    case Spades;
}

// 获取所有Suit枚举成员
$allSuits = Suit::cases();
/*
$allSuits 会是一个包含以下对象的数组：
[
    Suit::Hearts,
    Suit::Diamonds,
    Suit::Clubs,
    Suit::Spades
]
*/

登录后复制

提取基本枚举的名称

对于没有关联值的基本枚举（Pure Enums），我们可以通过访问每个枚举实例的 name 属性来获取其名称。结合 array_column 函数，可以简洁地提取所有名称。

enum Suit
{
    case Hearts;
    case Diamonds;
    case Clubs;
    case Spades;
}

$suitNames = array_column(Suit::cases(), 'name');
/*
$suitNames 会是：
[
    'Hearts',
    'Diamonds',
    'Clubs',
    'Spades'
]
*/

登录后复制

提取Backed枚举的关联值

如果枚举是“Backed Enum”（支持枚举），即每个枚举成员都关联了一个标量值（字符串或整数），我们可以通过访问每个枚举实例的 value 属性来获取这些关联值。同样，array_column 是一个非常方便的工具。

enum Suit: string
{
    case Hearts = 'H';
    case Diamonds = 'D';
    case Clubs = 'C';
    case Spades = 'S';
}

$suitValues = array_column(Suit::cases(), 'value');
/*
$suitValues 会是：
[
    'H',
    'D',
    'C',
    'S'
]
*/

登录后复制

使用特性（Trait）封装枚举值获取逻辑

为了避免在多个枚举中重复编写获取名称和值的逻辑，我们可以创建一个PHP特性（Trait）来封装这些常用操作。这样不仅能提高代码的复用性，还能使枚举定义更加清晰。

立即学习“PHP免费学习笔记（深入）”；

牛面

牛面AI面试，大厂级面试特训平台

147

查看详情

EnumToArray 特性定义

以下是一个名为 EnumToArray 的特性，它提供了三个静态方法：names()、values() 和 array()。

names()：返回所有枚举成员的名称数组。
values()：返回所有Backed枚举成员的关联值数组。
array()：返回一个关联数组，其中键是枚举的关联值，值是枚举的名称。

trait EnumToArray
{
    /**
     * 获取所有枚举成员的名称。
     * @return array
     */
    public static function names(): array
    {
        // self::cases() 在使用此trait的枚举上下文中有效
        return array_column(self::cases(), 'name');
    }

    /**
     * 获取所有Backed枚举成员的关联值。
     * 仅适用于Backed Enum。
     * @return array
     */
    public static function values(): array
    {
        // self::cases() 在使用此trait的枚举上下文中有效
        return array_column(self::cases(), 'value');
    }

    /**
     * 获取一个以关联值为键，名称为值的数组。
     * 仅适用于Backed Enum。
     * @return array
     */
    public static function array(): array
    {
        // 结合values()和names()方法
        return array_combine(self::values(), self::names());
    }
}

登录后复制

在枚举中使用 EnumToArray 特性

要使用这个特性，只需在你的枚举定义中通过 use EnumToArray; 引入即可。

enum Suit: string
{
    use EnumToArray; // 引入特性

    case Hearts = 'H';
    case Diamonds = 'D';
    case Clubs = 'C';
    case Spades = 'S';
}

// 使用特性提供的方法
$suitNames = Suit::names();
/*
$suitNames 会是：
[
    'Hearts',
    'Diamonds',
    'Clubs',
    'Spades'
]
*/

$suitValues = Suit::values();
/*
$suitValues 会是：
[
    'H',
    'D',
    'C',
    'S'
]
*/

$suitMap = Suit::array();
/*
$suitMap 会是：
Array
(
    [H] => Hearts
    [D] => Diamonds
    [C] => Clubs
    [S] => Spades
)
*/

登录后复制

注意事项

Trait的适用性： EnumToArray 特性中的 values() 和 array() 方法是为 Backed Enum 设计的。如果将其用于 Pure Enum（无关联值的枚举），array_column(self::cases(), 'value') 会导致错误，因为 Pure Enum 的实例没有 value 属性。在实际应用中，可以考虑为 Pure Enum 和 Backed Enum 分别创建不同的特性，或者在特性内部进行类型检查。
性能考量： Enum::cases() 在每次调用时都会返回一个新的数组，但其内部实现通常会缓存枚举实例，因此重复调用不会造成显著性能问题。array_column 也是一个高效的数组操作函数。
PHP版本要求： 枚举功能仅在 PHP 8.1 及更高版本中可用。

总结

PHP 8.1 引入的枚举功能极大地提升了代码的类型安全性和可读性。通过 Enum::cases() 方法，我们可以轻松获取所有枚举成员。结合 array_column，可以方便地提取成员名称或关联值。更进一步，利用特性（Trait）封装这些常用操作，如 EnumToArray 所示，可以有效地提高代码的复用性和维护性，使得枚举值的管理更加优雅和高效。在设计和使用枚举时，选择合适的策略来访问和操作其数据，将有助于构建更健壮、更易于维护的PHP应用程序。

以上就是PHP枚举值获取：全面指南与实用技巧的详细内容，更多请关注php中文网其它相关文章！