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

// 假设有一个枚举
enum Status
{
    case Active;
    case Inactive;
}

$status = Status::Active;

// 错误尝试
// is_enum($status); // 会导致错误：Call to undefined function is_enum()
// var_dump(gettype($status)); // 输出: string(6) "object"
// var_dump(gettype($status) === 'enum'); // 输出: bool(false)

if ($var instanceof \UnitEnum) {
    echo '变量是一个枚举类型';
} else {
    echo '变量不是一个枚举类型';
}

<?php

// 定义一个纯枚举 (Unit Enum)
enum Color
{
    case Red;
    case Green;
    case Blue;
}

// 定义一个带值枚举 (Backed Enum)
enum UserRole: int
{
    case Admin = 1;
    case Editor = 2;
    case Viewer = 3;
}

// 创建枚举实例
$redColor = Color::Red;
$adminRole = UserRole::Admin;

// 创建其他类型变量
$someObject = new stdClass();
$someString = "Hello";
$someInt = 123;
$someNull = null;

/**
 * 辅助函数：检测并输出变量类型
 *
 * @param mixed $var 要检测的变量
 * @param string $varName 变量名称，用于输出
 * @return void
 */
function checkEnumType(mixed $var, string $varName): void
{
    echo "检测变量 '$varName' (gettype: " . gettype($var) . "): ";
    if ($var instanceof \UnitEnum) {
        echo "是枚举类型。\n";
        // 对于枚举，可以进一步获取其名称和值（如果适用）
        echo "  - 枚举名称: " . $var->name . "\n";
        if ($var instanceof \BackedEnum) {
            echo "  - 枚举值: " . $var->value . "\n";
        }
    } else {
        echo "不是枚举类型。\n";
    }
    echo "----------------------------------------\n";
}

echo "--- 开始枚举类型检测 ---\n\n";

checkEnumType($redColor, '$redColor');
checkEnumType($adminRole, '$adminRole');
checkEnumType($someObject, '$someObject');
checkEnumType($someString, '$someString');
checkEnumType($someInt, '$someInt');
checkEnumType($someNull, '$someNull');

echo "--- 检测结束 ---\n";

?>

--- 开始枚举类型检测 ---

检测变量 '$redColor' (gettype: object): 是枚举类型。
  - 枚举名称: Red
----------------------------------------
检测变量 '$adminRole' (gettype: object): 是枚举类型。
  - 枚举名称: Admin
  - 枚举值: 1
----------------------------------------
检测变量 '$someObject' (gettype: object): 不是枚举类型。
----------------------------------------
检测变量 '$someString' (gettype: string): 不是枚举类型。
----------------------------------------
检测变量 '$someInt' (gettype: integer): 不是枚举类型。
----------------------------------------
检测变量 '$someNull' (gettype: NULL): 不是枚举类型。
----------------------------------------
--- 检测结束 ---