php - 如何在 PHP 中获取枚举的所有值？

Question

PHP 8.1 即将发布，包括对枚举的支持。我正在测试一些枚举功能，但找不到太多关于它的文档。因此我的问题是：如何获得枚举的所有值？

Answer 1

经过一番研究，我找到了答案。您可以使用静态方法：cases().

enum Status
{
    case PAID;
    case Cancelled;
}

Status::cases();

case 方法将返回一个数组，其中UnitEnum每个值都有一个枚举（接口）。

Answer 2

除了UnitEnum::cases()你可以用ReflectionEnum这个

$reflection = new ReflectionEnum(Status::class);

$reflection->getCases();

请注意，在这两种情况下，您都无法获得枚举方法。但只要ReflectionEnum扩展了，ReflectionClass那么您就可以使用其余的 ReflectionClass 方法，例如getMethods

Answer 3

需要值而不是 Enum 实例？

我为此编写了一个 Composer 包othyn/php-enum-enhancements，因为该UnitEnum::cases()方法不是我想要的，因为它返回一个MySuperCoolEnum实例数组而不是底层值作为它们的原始类型，这正是我想要的。

它的特征可以很容易地添加到执行以下操作的任何枚举中：

• 添加一个新的静态UnitEnum::valueArray(): array方法，将 Enum 中的所有值作为相同类型的 Enum 值数组返回

• 添加一个新的静态UnitEnum::valueList(string $separator = ', '): string方法，将枚举中的所有值作为逗号分隔的列表字符串返回

其中为普通枚举生成以下内容：

<?php

namespace App\Enums;

use Othyn\PhpEnumEnhancements\Traits\EnumEnhancements;

enum TestEnum
{
    use EnumEnhancements;

    case Alpha;
    case Bravo;
    case Charlie;
    case Delta;
    case Echo;
}

var_dump(TestEnum::valueArray());

// Results in the following being printed:
// array(5) {
//   [0]=>
//   string(5) "Alpha"
//   [1]=>
//   string(5) "Bravo"
//   [2]=>
//   string(7) "Charlie"
//   [3]=>
//   string(5) "Delta"
//   [4]=>
//   string(4) "Echo"
// }

var_dump(TestEnum::valueList());

// Results in the following being printed:
// string(34) "Alpha, Bravo, Charlie, Delta, Echo"

var_dump(TestEnum::valueList(separator: ':'));

// Results in the following being printed:
// string(30) "Alpha:Bravo:Charlie:Delta:Echo"

...以及支持枚举的以下内容，以下是string示例：

<?php

namespace App\Enums;

use Othyn\PhpEnumEnhancements\Traits\EnumEnhancements;

enum TestStringBackedEnum: string
{
    use EnumEnhancements;

    case Alpha   = 'alpha';
    case Bravo   = 'bravo';
    case Charlie = 'charlie';
    case Delta   = 'delta';
    case Echo    = 'echo';
}

var_dump(TestStringBackedEnum::valueArray());

// Results in the following being printed:
// array(5) {
//   [0]=>
//   string(5) "alpha"
//   [1]=>
//   string(5) "bravo"
//   [2]=>
//   string(7) "charlie"
//   [3]=>
//   string(5) "delta"
//   [4]=>
//   string(4) "echo"
// }

var_dump(TestStringBackedEnum::valueList());

// Results in the following being printed:
// string(34) "alpha, bravo, charlie, delta, echo"

var_dump(TestStringBackedEnum::valueList(separator: ':'));

// Results in the following being printed:
// string(30) "alpha:bravo:charlie:delta:echo"

...是的，它也适用于int's！

包的 README 的 Usage 部分有更多示例。