PHP 8.1+ 中判断变量是否为枚举类型的方法

<?php

// 定义一个纯枚举 (Pure Enum)
enum Status
{
    case Active;
    case Inactive;
    case Pending;
}

// 定义一个支持值的枚举 (Backed Enum)
enum Role: string
{
    case Admin = 'administrator';
    case Editor = 'editor';
    case Viewer = 'viewer';
}

// 定义一个普通类
class User
{
    public string $name;

    public function __construct(string $name)
    {
        $this->name = $name;
    }
}

// 测试变量
$activeStatus = Status::Active;
$adminRole = Role::Admin;
$userObject = new User('Alice');
$stringValue = 'hello';
$nullValue = null;
$integerValue = 123;

echo "--- 判断变量是否为枚举类型 ---" . PHP_EOL;

$variables = [
    'activeStatus' => $activeStatus,
    'adminRole' => $adminRole,
    'userObject' => $userObject,
    'stringValue' => $stringValue,
    'nullValue' => $nullValue,
    'integerValue' => $integerValue,
];

foreach ($variables as $name => $value) {
    if ($value instanceof \UnitEnum) {
        echo "变量 '$name' 是一个枚举类型。" . PHP_EOL;
    } else {
        echo "变量 '$name' 不是一个枚举类型。" . PHP_EOL;
    }
}

echo PHP_EOL . "--- 进一步区分纯枚举和支持值的枚举 ---" . PHP_EOL;

// 如果需要区分纯枚举和支持值的枚举，可以使用 \BackedEnum 接口
// \BackedEnum 接口继承自 \UnitEnum，并额外定义了 value 属性。
foreach ($variables as $name => $value) {
    if ($value instanceof \BackedEnum) {
        echo "变量 '$name' 是一个支持值的枚举 (Backed Enum)，其值为: " . $value->value . PHP_EOL;
    } elseif ($value instanceof \UnitEnum) {
        echo "变量 '$name' 是一个纯枚举 (Pure Enum)。" . PHP_EOL;
    } else {
        echo "变量 '$name' 既不是纯枚举也不是支持值的枚举。" . PHP_EOL;
    }
}

?>

--- 判断变量是否为枚举类型 ---
变量 'activeStatus' 是一个枚举类型。
变量 'adminRole' 是一个枚举类型。
变量 'userObject' 不是一个枚举类型。
变量 'stringValue' 不是一个枚举类型。
变量 'nullValue' 不是一个枚举类型。
变量 'integerValue' 不是一个枚举类型。

--- 进一步区分纯枚举和支持值的枚举 ---
变量 'activeStatus' 是一个纯枚举 (Pure Enum)。
变量 'adminRole' 是一个支持值的枚举 (Backed Enum)，其值为: administrator
变量 'userObject' 既不是纯枚举也不是支持值的枚举。
变量 'stringValue' 既不是纯枚举也不是支持值的枚举。
变量 'nullValue' 既不是纯枚举也不是支持值的枚举。
变量 'integerValue' 既不是纯枚举也不是支持值的枚举。