PHP枚举

PHP 8.1新增

基础

Enum类似class

枚举的case可以定义0个或多个

枚举间对比没有意义，总是返回false。case是可以对比的

<?php
 
enum Colors
{
    case Red;
    case Blue;
    case Green;
 
    public function getColor(): string
    {
        return $this->name;
    }
}

function paintColor(Colors $colors): void
{
    echo "Paint : " . $colors->getColor() . PHP_EOL;
}
 
paintColor(Colors::Red);
paintColor(Colors::Green);
paintColor(Colors::Blue);
 
/*
 output :
 ------------------------
 Paint : Red
 Paint : Green
 Paint : Blue
 */

回退枚举

case默认是类实现的，case可以赋值标量，这时case的类型会由复杂类型转为简单类型，这种称为回退
回退枚举只有一个value属性
回退枚举实现了BackedEnuminterface，额外暴露了from()、tryFrom()方法
枚举值必须是确定的，不能是可变的

<?php
enum Suit: string
{
    case Hearts = 'H';
    case Diamonds = 'D';
    case Clubs = 'C';
    case Spades = 'S';
}

print Suit::Clubs->value;
print Suit::from('H');
print Suit::tryFrom('XX') ?? Suit::Hearts;

枚举方法

枚举能定义自己的方法、静态方法，也能实现interface，但是不支持继承
因为不支持继承所以访问修饰符没什么用，都有public即可

<?php
interface Colorful
{
    public function color(): string;
}
 
enum Suit implements Colorful
{
    case Hearts;
    case Diamonds;
    case Clubs;
    case Spades;
 
    // 满足 interface 契约。
    public function color(): string
    {
        return match($this) {
            Suit::Hearts, Suit::Diamonds => 'Red',
            Suit::Clubs, Suit::Spades => 'Black',
        };
    }
 
    // 不是 interface 的一部分；也没问题
    public function shape(): string
    {
        return "Rectangle";
    }

    // 静态方法
    public static function fromLength(int $cm): static
    {
        return match(true) {
            $cm < 50 => static::Hearts,
            $cm < 100 => static::Diamonds,
            default => static::Clubs,
        };
    }

}
 
function paint(Colorful $c) { ... }
 
paint(Suit::Clubs);  // 正常
 
print Suit::Diamonds->shape(); // 输出 "Rectangle"

枚举常量

<?php
enum Size
{
    case Small;
    case Medium;
    case Large;
 
    public const Huge = self::Large;
}

使用Trait

在enum中使用trait时，不允许trait中包含属性，只能存在方法、静态方法