PHP原生枚举类型提示与检查问题及MyCLabs迁移困惑

1. 参数/返回值的枚举类型提示 #

PHP原生枚举支持直接用具体枚举类作为类型提示，比如你定义了一个OrderStatus枚举：

enum OrderStatus: string {
    case PENDING = 'pending';
    case SHIPPED = 'shipped';
}

那么在函数中可以直接指定类型：

// 参数类型提示
function setOrderStatus(OrderStatus $status): void {
    // ...
}

// 返回值类型提示
function getDefaultStatus(): OrderStatus {
    return OrderStatus::PENDING;
}

如果需要接受任意原生枚举作为参数（不限制具体枚举类），可以利用PHP内置的两个枚举接口：

• UnitEnum：所有无值枚举（仅定义case，没有关联值）都实现此接口
• BackedEnum：所有带值枚举（关联字符串/整数）都实现此接口

示例：

// 接受任意原生枚举
function processEnum(UnitEnum $enum): void {
    // ...
}

// 仅接受带值枚举
function processBackedEnum(BackedEnum $enum): void {
    // 可以安全调用$enum->value获取枚举值
    echo $enum->value;
}

2. 检查值是否为原生枚举 #

你不需要用反射来判断，直接通过instanceof结合内置接口就能高效检查：

// 检查是否为任意原生枚举
if ($value instanceof UnitEnum) {
    // 是原生枚举
}

// 检查是否为带值的原生枚举
if ($value instanceof BackedEnum) {
    // 是带值的原生枚举
}

关于“倒退”的误解 #

你的处理方式确实不够高效，但这不是原生枚举的问题——原生枚举的类型系统支持比MyCLabs Enums更完善：

• 具体枚举类的类型提示能提供更强的编译期类型检查，避免传入错误枚举
• 内置接口的存在让“任意枚举”的类型约束和检查更简洁，性能也比反射好得多

内容的提问来源于stack exchange，提问作者Maarten de Jager