PHP8怎么用枚举定义订单状态-php教程-PHP中文网

php 8.1 原生枚举（enum）适合定义订单状态，提升安全性与可读性；推荐使用标量枚举绑定字符串或整数值，支持方法扩展、类型提示、laravel 自动转换及数据库灵活配合。

php8怎么用枚举定义订单状态

PHP 8.1 引入了原生枚举（enum），非常适合用来定义订单状态这类固定、语义明确的值。相比用常量或字符串，枚举更安全、可读性更强，还能配合类型提示和匹配（match）做精准处理。

定义带值的枚举（推荐）

订单状态通常需要对应数据库存储值（如 0、1）或前端展示文案。用**标量枚举（scalar enum）**，为每个状态绑定一个底层值（int 或 string）：

enum OrderStatus: string
{
    case Pending = 'pending';
    case Confirmed = 'confirmed';
    case Shipped = 'shipped';
    case Delivered = 'delivered';
    case Cancelled = 'cancelled';
}

用 string 类型便于日志、API 返回和数据库字段对齐（比如 MySQL 的 ENUM 或 VARCHAR）
也可用 int： enum OrderStatus: int { case Pending = 0; case Confirmed = 1; ... }
枚举值不可变，无法被外部修改，避免非法状态注入

添加方法增强可读性

在枚举里加静态方法或实例方法，让状态更“有含义”：

btpanel phpsite 宝塔面板PHP网站

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

下载

enum OrderStatus: string
{
    case Pending = 'pending';
    case Confirmed = 'confirmed';
    case Shipped = 'shipped';
    case Delivered = 'delivered';
    case Cancelled = 'cancelled';

    public function label(): string
    {
        return match($this) {
            self::Pending => '待确认',
            self::Confirmed => '已确认',
            self::Shipped => '已发货',
            self::Delivered => '已签收',
            self::Cancelled => '已取消',
        };
    }

    public function isFinal(): bool
    {
        return $this === self::Delivered || $this === self::Cancelled;
    }
}

$status->label() 直接获取中文描述，不用额外映射数组
$status->isFinal() 封装业务逻辑，判断是否为终态，避免散落各处的硬编码比较
方法可被 IDE 自动补全，类型安全

在模型和控制器中使用

结合 Laravel（或其他框架）时，可自然融入类型系统：

// 订单模型
class Order extends Model
{
    protected $casts = [
        'status' => OrderStatus::class, // PHP 8.2+ 支持自动 cast（Laravel 10.28+）
    ];
}

// 控制器中
public function updateStatus(Request $request, Order $order)
{
    $newStatus = OrderStatus::from($request->input('status')); // 安全转换，失败抛 ValueError

    if ($newStatus->isFinal() && $order->status->isFinal()) {
        throw new ValidationException('终态订单不可再次更新');
    }

    $order->status = $newStatus;
    $order->save();
}