PHP 8.1的枚举功能怎么用才顺手-php教程-PHP中文网

backedenum必须显式声明底层类型（如enum e: string）才支持->value，纯枚举仅支持->name；::cases()返回实例数组，取名称或值需配合array_column()；反查用户输入应始终用tryfrom()而非from()。

php 8.1的枚举功能怎么用才顺手

直接用 `->name` 和 `->value` 拿标识和值，但得先分清是不是 backed enum

纯枚举（unit enum）只有 ->name，没有 ->value；只有声明了 enum E: string 或 enum E: int 的 backed enum 才有 ->value。硬写 Status::Draft->value 会报 Fatal error: Cannot access value property on unit enum case。

常见错误是定义时漏掉冒号和类型，比如写成 enum Status { case Draft; } 却在别处试图读 ->value。要读值，必须显式声明底层类型。

需要存数据库或传给 API？选 : string 或 : int
只做状态分类、无外部映射？用纯枚举更轻量，也避免误用 ->value
->name 始终可用，且是只读属性，不能赋值

遍历所有选项别手写数组，用 `::cases()` + `array_column()`

Status::cases() 返回的是枚举实例数组，不是字符串列表。直接 print_r(Status::cases()) 看到的是一堆对象，不直观。

想取全部名称（比如填下拉框）：用 array_column(Status::cases(), 'name')；想取全部值（backed enum）：用 array_column(Status::cases(), 'value')。

别用 get_class_vars() 或反射——没必要，::cases() 是官方正路
别在迁移里直接传 Status::cases() 给 Laravel 的 enum() 字段——它要字符串数组，不是对象数组
Laravel 迁移中正确写法是：array_column(Status::cases(), 'value') 或 array_column(Status::cases(), 'name')，取决于你字段存的是语义名还是底层值

从用户输入反查枚举，死守 `::tryFrom()`，别碰 `::from()`

::from() 匹配失败直接抛 ValueError，HTTP 请求、表单提交、JSON 解析这类场景根本没法兜底；::tryFrom() 失败返回 null，可控。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

典型错误是把 $_GET['status'] 直接喂给 Status::from()，一来非法值就崩。必须先判空：

$status = Status::tryFrom($_GET['status'] ?? '');
if ($status === null) {
    throw new InvalidArgumentException('Invalid status');
}

::tryFrom() 只对 backed enum 有效，unit enum 没这个方法
字符串匹配区分大小写，tryFrom('DRAFT') 对 case Draft = 'draft' 返回 null
整型 backed enum 中，tryFrom('200') 能匹配 case OK = 200（PHP 自动类型转换），但 tryFrom(200.0) 不行

加方法别往枚举里塞实例方法，用静态方法或 trait 封装逻辑

PHP 枚举不允许定义实例方法，写 public function label() 会直接报 ParseError: Enum cases cannot have methods。所有行为逻辑得靠静态方法或外部 trait。

比如要支持中文标签、判断是否为终态，推荐用 trait 复用：

trait EnumHelper {
    public static function labels(): array {
        return match (static::class) {
            Status::class => ['Draft' => '草稿', 'Published' => '已发布'],
            default => [],
        };
    }
}