owl-admin/app/Enums/CommentStatus.php

<?php

namespace App\Enums;

/**
 * 评论状态枚举类
 */
enum CommentStatus: int
{
    /**
     * 评论状态：待评论
     */
    case PENDING = 1;

    /**
     * 评论状态：已评论
     */
    case COMMENTED = 2;

    /**
     * 获取状态的显示文本
     *
     * @return string 状态的中文描述
     */
    public function label(): string
    {
        return match ($this) {
            self::PENDING => '待评论',
            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::PENDING->value => self::PENDING,
            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::PENDING->value => self::PENDING->label(),
            self::COMMENTED->value => self::COMMENTED->label(),
        ];
    }

    /**
     * 将枚举转换为字符串
     *
     * 使用示例:
     * $status = CommentStatus::PENDING;
     *
     * // 与字符串比较
     * if ($status == '1') { // 可以直接与字符串比较
     *     // do something
     * }
     *
     * // 与数字比较
     * if ($status == 1) { // 可以直接与数字比较
     *     // do something
     * }
     *
     * echo $status; // 输出 "1"
     * $str = (string)$status; // 显式转换为字符串 "1"
     * $num = (int)$status; // 显式转换为数字 1
     *
     * @return string 返回枚举的值的字符串形式
     */
    public function __toString(): string
    {
        return (string) $this->value;
    }

}