PHP 7.4 不支持原生 enum，class+const 模拟缺失类型约束、不可序列化、不支持 match、无 IDE 提示；推荐用 myclabs/php-enum 库或手写抽象 Enum 基类，但长期应升级至 PHP 8.1+ 使用原生枚举。
PHP 7.4 项目无法原生使用 enum 关键字，直接写会报 ParseError: syntax error, unexpected 'enum'。必须用兼容方案模拟枚举行为，且不能只靠 class + const —— 那种写法漏掉类型约束、不可序列化、不支持 match、IDE 无提示，上线后照样出错。
为什么不能只用 class + const 模拟
常见错误是这样写：
class OrderStatus
{
const PENDING = 'pending';
const SHIPPED = 'shipped';
}
问题很直接：
- 赋值时无法校验：
$order->status = 'pendding';不会报错，但语义已错 - 类型提示失效：
function handle(OrderStatus $s)实际接收的是字符串，PHP 不认 - 无法用于
match表达式，也不能被 IDE 自动补全OrderStatus::后的常量 - JSON 序列化后只剩字符串，反序列化时丢失“这是哪个枚举”的上下文
推荐方案：myclabs/php-enum（PHP 7.4 兼容）
这是目前最成熟、Laravel 生态广泛验证过的兼容方案。它逼近原生枚举的契约，关键点在于：每个状态是单例对象、支持 from()/tryFrom()、可类型约束、能和 Eloquent Cast 配合。
立即学习“PHP免费学习笔记（深入）”；
实操步骤：
- 执行
composer require myclabs/php-enum - 创建
app/Enums/OrderStatus.php，继承MyCLabs\Enum\Enum - 定义
private const PENDING = 'pending';等底层值（注意是private const，不是public const） - 在模型中用
$order->status = OrderStatus::SHIPPED();赋值，非法值会抛UnexpectedValueException
⚠️ 注意：该库返回的 getValue() 是字符串，若数据库字段是 tinyint，需额外加 Cast 映射层，否则存库时报错。
自定义抽象基类（轻量但需手动补全）
如果不想引入第三方依赖，可用 PHP 7.4 原生语法手写一个最小可行模拟。核心是封禁克隆、保证单例、提供 from() 和 tryFrom()：
abstract class Enum
{
private static array $instances = [];
final private function __construct() {}
final private function __clone() {}
final public function __wakeup()
{
throw new \BadMethodCallException('Cannot unserialize enum');
}
public static function from(string $value): static
{
$class = static::class;
if (!isset(self::$instances[$class][$value])) {
throw new \ValueError("Invalid value: {$value}");
}
return self::$instances[$class][$value];
}
public static function tryFrom(string $value): ?static
{
$class = static::class;
return self::$instances[$class][$value] ?? null;
}
}
// 使用示例
final class OrderStatus extends Enum
{
private const PENDING = 'pending';
private const SHIPPED = 'shipped';
private function __construct(private string $value) {}
public static function PENDING(): self
{
return self::getInstance(self::PENDING);
}
public static function SHIPPED(): self
{
return self::getInstance(self::SHIPPED);
}
private static function getInstance(string $value): self
{
$class = static::class;
if (!isset(self::$instances[$class][$value])) {
self::$instances[$class][$value] = new self($value);
}
return self::$instances[$class][$value];
}
public function getValue(): string
{
return $this->value;
}
}
这个写法能解决类型安全和单例问题，但缺点也很明显：
- 没有 IDE 自动补全（
OrderStatus::后不提示方法） - 不支持
match表达式，仍得用if或switch - JSON 序列化需手动实现
JsonSerializable接口
升级 PHP 版本才是长期解
PHP 7.4 已于 2022 年 11 月结束生命周期，当前（2026年10月）主流 LTS 版本是 PHP 8.1+。如果你的项目还在用 7.4，那枚举兼容只是表象问题，背后是安全更新缺失、新特性无法落地、维护成本持续抬升。哪怕暂时不能切到 8.1，也建议规划迁移路径 —— 因为所有模拟方案都只是“堵漏”，而原生 enum 是从语言层面把无效状态关在门外。
