想用好 php enum 功能？这些常见用法必须要掌握！

发布日期： 2025-09-30 阅读量： 作者： admin

大家今天想跟大家唠唠 PHP 的枚举（enum）这个东西。我这人就喜欢动手实践，记录下过程，今天正好分享下我最近捣鼓 PHP 枚举的这点事儿。

我记得以前，还在用 PHP 7 或者更早版本的时候，处理一些固定的状态或者类型，那叫一个头疼。比如说，订单状态，可能有“待支付”、“已支付”、“处理中”、“已发货”、“已完成”、“已取消”这么几种。我们通常咋办？

用常量：在类里面定义一堆 `const STATUS_PENDING = 1;` `const STATUS_PAID = 2;` 这种。用数字还行，但有时候你想要用字符串，比如 `'pending'`, `'paid'`，那就得 `const STATUS_PENDING = 'pending';` 这样。也还凑合，但总感觉差点意思，不够“类型化”。
用注释或者文档约定：直接在代码里用字符串或者数字，然后在注释里写明白 'pending' 代表1 代表这简直是给自己挖坑，时间长了或者换个人维护，很容易就搞混了，或者写错字母大小写啥的。
用第三方库：也有人用一些社区的库来实现类似枚举的功能，比如那个 `myclabs/php-enum`。确实能解决问题，但就像说明里提到的，总觉得不是“原生”的，还得额外装个库，有点麻烦。

反正就是，一直没有一个官方的、语言层面支持的、用起来特别顺手的方案。

后来 PHP 8.1 出来了，我看到更新日志里提到了原生支持枚举（Enum）！当时就觉得，这个可以有！终于等到官方出手了。正好手头有个小项目，我就寻思着，升级到 PHP 8.1，试试这个新特性到底咋样。

开始动手试试

第一步，当然是把我的开发环境升级到 PHP 8.1 或更高版本。这个过程就不细说了，反正就是装好新版本，配置好环境。

然后，我就开始照着文档试着写第一个枚举。比如，就拿刚才那个订单状态的例子：

enum OrderStatus {


case Pending;
case Paid;
case Processing;
case Shipped;
case Completed;
case Cancelled;

感觉挺简洁的！ 就用 `enum` 关键字定义一个枚举类型，里面用 `case` 定义每个可能的值。这玩意儿它本身就是一个类型了。

怎么用？比如我有个函数，需要接收订单状态：

function updateOrderStatus(OrderId $orderId, OrderStatus $newStatus) {


// ... 更新数据库里的状态
echo "更新订单 " . $orderId->getId() . " 的状态为: " . $newStatus->name; // ->name 可以获取 case 的名字

在调用的时候，就可以这样：

$orderId = new OrderId(123);


updateOrderStatus($orderId, OrderStatus::Processing); // 直接用 :: 访问枚举成员

这一下子就感觉舒服多了！

类型安全： 函数签名里直接写明了需要 `OrderStatus` 类型，你传个字符串 'processing' 或者数字 3 进去，直接就报错了。这就避免了很多低级错误，特别是团队协作的时候，大家一看就知道这里该传什么。
代码清晰： `OrderStatus::Processing` 比起一个魔术数字 `3` 或者字符串 `'processing'`，可读性强太多了，一眼就知道是啥意思。
IDE 支持 现在的 IDE 都能很好地识别枚举，有自动补全，还能检查类型，写代码效率也高了。

更进一步：带值的枚举（Backed Enums）

光有名字还不够，很多时候我们还是需要把枚举成员跟一个实际的值（比如数据库里存的整数或者字符串）关联起来。PHP 枚举也考虑到了这一点，搞了个叫 “Backed Enums” 的东西。

比如，我想让订单状态在数据库里存成字符串：

enum OrderStatusBacked: string {


case Pending = 'pending';
case Paid = 'paid';
case Processing = 'processing';
case Shipped = 'shipped';
case Completed = 'completed';
case Cancelled = 'cancelled';

注意，这里在枚举名字后面加了个 `: string`，表示这个枚举的值是字符串类型，并且每个 `case` 后面都用 `=` 赋了一个实际的字符串值。也可以是 `: int`。

用起来也很方便：

$status = OrderStatusBacked::Paid;


// 获取枚举成员的值 ('paid')
$valueForDatabase = $status->value;
// 从值反过来获取枚举成员 (如果数据库里读出来的是 'shipped')
$statusFromDb = OrderStatusBacked::from('shipped'); // 如果 'shipped' 存在，返回 OrderStatusBacked::Shipped
// 还有一个 tryFrom 方法，如果值不存在不会报错，而是返回 null
$maybeStatus = OrderStatusBacked::tryFrom('unknown_status'); // 返回 null

这个 Backed Enums 对我来说特别实用！ 因为和数据库打交道是常有的事儿。可以直接把 `$status->value` 存进去，读出来的时候用 `::from()` 或 `::tryFrom()` 转回来，代码逻辑清晰多了。

实践下来的一些感受

我在项目里用了 PHP 8.1 的原生枚举之后，感觉是：

代码质量提升了： 类型约束让代码更健壮，减少了因为状态值写错、传错导致的 bug。
可读性增强了： 枚举的名字比魔法数字或字符串更容易理解。
开发效率提高了： IDE 的支持让编码更快，重构也更安全。
维护成本降低了： 新人接手代码时，对这些固定的状态集合更容易理解。

也不是说所有地方都非得用枚举。对于那些真正代表“一组有限的、固定的选项”的场景，比如状态、类型、角色等等，用枚举就特别合适。

好了，这回就先分享这么多我实践 PHP 枚举的过程和体会。个人感觉这是 PHP 8.1 里一个非常棒的改进，如果你还没用上，项目条件也允许的话，真的可以试试看，确实能省不少事儿。

上一篇: 香港云服务器哪家好？看完这篇帮你选对不踩坑！

想用好 php enum 功能？这些常见用法必须要掌握！

随便看看