owl-admin/app/Enums/OrderStatus.php

<?php

namespace App\Enums;

/**
 * 订单状态枚举类
 */
enum OrderStatus: int
{
    /**
     * 订单状态：下单
     */
    case CREATED = 1;

    /**
     * 订单状态：指定
     */
    case ASSIGNED = 2;

    /**
     * 订单状态：支付
     */
    case PAID = 3;

    /**
     * 订单状态：取消
     */
    case CANCELLED = 4;

    /**
     * 订单状态：退款中
     */
    case REFUNDING = 5;

    /**
     * 订单状态：退款成功
     */
    case REFUNDED = 6;

    /**
     * 订单状态：退款失败
     */
    case REFUND_FAILED = 7;

    /**
     * 订单状态：接单
     */
    case ACCEPTED = 8;

    /**
     * 订单状态：出发
     */
    case DEPARTED = 9;

    /**
     * 订单状态：到达
     */
    case ARRIVED = 10;

    /**
     * 订单状态：服务中
     */
    case SERVING = 11;

    /**
     * 订单状态：服务结束
     */
    case FINISHED = 12;

    /**
     * 订单状态：撤离
     */
    case LEFT = 13;

    /**
     * 订单状态：已评价
     */
    case COMMENTED = 14;

    /**
     * 获取状态的显示文本
     *
     * @return string 状态的中文描述
     */
    public function label(): string
    {
        return match ($this) {
            self::CREATED => '下单',
            self::ASSIGNED => '指定',
            self::PAID => '支付',
            self::CANCELLED => '取消',
            self::REFUNDING => '退款中',
            self::REFUNDED => '退款成功',
            self::REFUND_FAILED => '退款失败',
            self::ACCEPTED => '接单',
            self::DEPARTED => '出发',
            self::ARRIVED => '到达',
            self::SERVING => '服务',
            self::FINISHED => '结束',
            self::LEFT => '撤离',
            self::COMMENTED => '评价',
        };
    }

    /**
     * 获取状态的整数值
     *
     * @return int 状态值
     */
    public function value(): int
    {
        return $this->value;
    }

    /**
     * 检查当前状态是否与指定状态相同
     *
     * @param  self  $status  要比较的状态
     * @return bool 如果状态相同返回 true，否则返回 false
     */
    public function is(self $status): bool
    {
        return $this === $status;
    }

    /**
     * 根据整数值创建对应的状态枚举实例
     *
     * @param  int  $value  状态值
     * @return self|null 返回对应的状态枚举实例，如果值无效则返回 null
     */
    public static function fromValue(int $value): ?self
    {
        return match ($value) {
            self::CREATED->value => self::CREATED,
            self::ASSIGNED->value => self::ASSIGNED,
            self::PAID->value => self::PAID,
            self::CANCELLED->value => self::CANCELLED,
            self::REFUNDING->value => self::REFUNDING,
            self::REFUNDED->value => self::REFUNDED,
            self::REFUND_FAILED->value => self::REFUND_FAILED,
            self::ACCEPTED->value => self::ACCEPTED,
            self::DEPARTED->value => self::DEPARTED,
            self::ARRIVED->value => self::ARRIVED,
            self::SERVING->value => self::SERVING,
            self::FINISHED->value => self::FINISHED,
            self::LEFT->value => self::LEFT,
            self::COMMENTED->value => self::COMMENTED,
            default => null
        };
    }

    /**
     * 获取所有状态的值数组
     *
     * @return array 包含所有状态值的数组
     */
    public static function values(): array
    {
        return array_column(self::cases(), 'value');
    }

    /**
     * 获取所有状态的键值对数组
     *
     * @return array 状态值作为键，显示文本作为值的关联数组
     */
    public static function all(): array
    {
        return [
            self::CREATED->value => self::CREATED->label(),
            self::ASSIGNED->value => self::ASSIGNED->label(),
            self::PAID->value => self::PAID->label(),
            self::CANCELLED->value => self::CANCELLED->label(),
            self::REFUNDING->value => self::REFUNDING->label(),
            self::REFUNDED->value => self::REFUNDED->label(),
            self::REFUND_FAILED->value => self::REFUND_FAILED->label(),
            self::ACCEPTED->value => self::ACCEPTED->label(),
            self::DEPARTED->value => self::DEPARTED->label(),
            self::ARRIVED->value => self::ARRIVED->label(),
            self::SERVING->value => self::SERVING->label(),
            self::FINISHED->value => self::FINISHED->label(),
            self::LEFT->value => self::LEFT->label(),
            self::COMMENTED->value => self::COMMENTED->label(),
        ];
    }
}