PHP 8 - 枚举

无涯私塾网

链接:https://www.learnfk.com/article-php-enums

来源:LearnFk无涯私塾网

像往常一样，使用无涯教程的PHP函数帖子，无涯教程从高级概述开始，枚举是什么样的:

enum Status
{
    case DRAFT;
    case PUBLISHED;
    case ARCHIVED;
}

枚举的好处是它们代表了一个常量值的集合，但最重要的是可以输入这些值，如:

class BlogPost
{
    public function __construct(
        public Status $status, 
    ) {}
}

在此示例中，创建枚举并将其传递给 blogpost 如下所示:

$post = new BlogPost(Status::DRAFT);

这是基本的方式，因为你可以看到没有任何复杂的事情。

# 枚举方法

枚举可以定义方法，就像类一样。这是一个非常强大的函数，特别是与 match 运算符配合使用:

enum Status
{
    case DRAFT;
    case PUBLISHED;
    case ARCHIVED;
    
    public function color(): string
    {
        return match($this) 
        {
            Status::DRAFT => 'grey',   
            Status::PUBLISHED => 'green',   
            Status::ARCHIVED => 'red',   
        };
    }
}

方法可以如此使用:

无涯教程网

$status = Status::ARCHIVED;

$status->color(); // 'red'

允许静态方法:

enum Status
{
    // …
    
    public static function make(): Status
    {
        // …
    }
}

您也可以使用 self :

enum Status
{
    // …
    
    public function color(): string
    {
        return match($this) 
        {
            self::DRAFT => 'grey',   
            self::PUBLISHED => 'green',   
            self::ARCHIVED => 'red',   
        };
    }
}

# 枚举接口

枚举可以实现接口，就像普通类一样:

interface HasColor
{
    public function color(): string;
}

enum Status implements HasColor
{
    case DRAFT;
    case PUBLISHED;
    case ARCHIVED;
    
    public function color(): string { /* … */ }
}

# 枚举值 

枚举值由内部的对象表示，但如果您愿意，可以为它们分配一个值;

enum Status: string
{
    case DRAFT = 'draft';
    case PUBLISHED = 'published';
    case ARCHIVED = 'archived';
}

注意枚举定义中的类型声明。它表示所有枚举值都是给定类型的。您也可以使其成为 int 。请注意，仅 int 和 String 被允许作为枚举值。

enum Status: int
{
    case DRAFT = 1;
    case PUBLISHED = 2;
    case ARCHIVED = 3;
}

enum Status: string implements HasColor
{
    case DRAFT = 'draft';
    case PUBLISHED = 'published';
    case ARCHIVED = 'archived';
    
    // …
}

$value = Status::PUBLISHED->value; // 2

$status = Status::from(2); // Status::PUBLISHED

$status = Status::from('unknown'); // ValueError
$status = Status::tryFrom('unknown'); // null

Status::cases();

/* [
    Status::DRAFT, 
    Status::PUBLISHED, 
    Status::ARCHIVED
] */

array_map(
    fn(Status $status) => $status->color(), 
    Status::cases()
);

Status::cases();

/* [
    'draft' => Status::DRAFT, 
    'published' => Status::PUBLISHED, 
    'archived' => Status::ARCHIVED,
] */

$statusA = Status::PENDING;
$statusB = Status::PENDING;
$statusC = Status::ARCHIVED;

$statusA === $statusB; // true
$statusA === $statusC; // false
$statusC instanceof Status; // true

$list = [
    Status::DRAFT => 'draft',
    // …
];