PHP：枚举方法 - 手册 - PHP 编程语言

枚举方法

枚举（纯枚举和支持枚举）可以包含方法，并且可以实现接口。如果枚举实现了接口，则对该接口的任何类型检查也将接受该枚举的所有情况。

<?php

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

enum Suit implements Colorful
{
 case Hearts;
 case Diamonds;
 case Clubs;
 case Spades;

 // 满足接口契约。
 public function color(): string
 {
 return match($this) {
 Suit::Hearts, Suit::Diamonds => 'Red',
 Suit::Clubs, Suit::Spades => 'Black',
 };
 }

 // 不是接口的一部分；这没关系。
 public function shape(): string
 {
 return "Rectangle";
 }
}

function paint(Colorful $c)
{
 /* ... */
}

paint(Suit::Clubs); // 工作正常

print Suit::Diamonds->shape(); // 输出 "Rectangle"
?>

在这个例子中，Suit 的所有四个实例都有两个方法，color() 和 shape()。就调用代码和类型检查而言，它们的行为与任何其他对象实例完全相同。

在支持枚举中，接口声明在支持类型声明之后。

<?php

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

enum Suit: string implements Colorful
{
 case Hearts = 'H';
 case Diamonds = 'D';
 case Clubs = 'C';
 case Spades = 'S';

 // 满足接口契约。
 public function color(): string
 {
 return match($this) {
 Suit::Hearts, Suit::Diamonds => 'Red',
 Suit::Clubs, Suit::Spades => 'Black',
 };
 }
}
?>

在方法内部，$this 变量被定义并引用 Case 实例。

方法可以任意复杂，但在实践中通常会返回一个静态值或对 $this 使用 match 以针对不同的情况提供不同的结果。

请注意，在这种情况下，更好的数据建模实践也将定义一个具有 Red 和 Black 值的 SuitColor 枚举类型并返回它。但是，这会使此示例变得复杂。

上述层次结构在逻辑上类似于以下类结构（尽管这不是实际运行的代码）

<?php

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

final class Suit implements UnitEnum, Colorful
{
 public const Hearts = new self('Hearts');
 public const Diamonds = new self('Diamonds');
 public const Clubs = new self('Clubs');
 public const Spades = new self('Spades');

 private function __construct(public readonly string $name) {}

 public function color(): string
 {
 return match($this) {
 Suit::Hearts, Suit::Diamonds => 'Red',
 Suit::Clubs, Suit::Spades => 'Black',
 };
 }

 public function shape(): string
 {
 return "Rectangle";
 }

 public static function cases(): array
 {
 // 非法方法，因为不允许在枚举上手动定义 cases() 方法。
 // 另请参阅“值列表”部分。
 }
}
?>

方法可以是公共的、私有的或受保护的，尽管在实践中私有和受保护是等效的，因为不允许继承。

发现问题？

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献的注释 1 条注释

踩

iloveyii at yahoo dot com ¶

1 年前

只是为了完成上面简洁示例中的 shape 函数

<?php
接口 Colorful
{
 public function color(): string;
}

枚举 Suit 实现 Colorful
{
 case Hearts;
 case Diamonds;
 case Clubs;
 case Spades;

 // 满足接口契约。
 public function color(): string
 {
 return match($this) {
 Suit::Hearts, Suit::Diamonds => 'Red',
 Suit::Clubs, Suit::Spades => 'Black',
 };
 }

 // 不是接口的一部分；这没关系。
 public function shape(): string
 {
 return match($this) {
 Suit::Hearts => '❤️', 
 Suit::Diamonds => '💎', 
 Suit::Clubs => '♣️', 
 Suit::Spades => ' ♠️'
 };
 
 }
}

echo Suit::Diamonds->shape();
echo PHP_EOL;
echo Suit::Clubs->shape();

＋添加注释