PHP：示例 - 手册 - PHP 编程语言

示例

示例 #1 基本有限值

<?php

enum SortOrder
{
 case Asc;
 case Desc;
}

function query($fields, $filter, SortOrder $order = SortOrder::Asc)
{
 /* ... */
}
?>

query() 函数现在可以安全地进行处理，因为它知道 $order 保证是 SortOrder::Asc 或 SortOrder::Desc 之一。任何其他值都会导致 TypeError，因此无需进一步的错误检查或测试。

示例 #2 高级互斥值

<?php

enum UserStatus: string
{
 case Pending = 'P';
 case Active = 'A';
 case Suspended = 'S';
 case CanceledByUser = 'C';

 public function label(): string
 {
 return match($this) {
 static::Pending => 'Pending',
 static::Active => 'Active',
 static::Suspended => 'Suspended',
 static::CanceledByUser => 'Canceled by user',
 };
 }
}
?>

在这个例子中，用户的状态可以是，并且只能是 UserStatus::Pending、UserStatus::Active、UserStatus::Suspended 或 UserStatus::CanceledByUser 之一。函数可以针对 UserStatus 对参数进行类型声明，并且只接受这四个值。

所有四个值都有一个 label() 方法，该方法返回一个人类可读的字符串。该字符串独立于“机器名称”标量等效字符串，后者可用于数据库字段或HTML选择框等。

<?php

foreach (UserStatus::cases() as $case) {
 printf('<option value="%s">%s</option>\n', $case->value, $case->label());
}
?>

发现问题？

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

＋添加备注

用户贡献的备注 1 条备注

顶

踩

php-net at mentordosnerds dot com ¶

1 年前

其他用例示例
<?php

trait EnumNamesTrait
{
 abstract public static function cases(): array;
 
 public static function names(): array
 {
 return array_map(fn($enum) => $enum->name, static::cases());
 }
}

trait EnumValuesTrait
{
 abstract public static function cases(): array;
 
 public static function values(): array
 {
 return array_map(fn($enum) => $enum->value, static::cases());
 }
}

trait EnumArraySerializableTrait
{
 use EnumNamesTrait;
 use EnumValuesTrait;
 
 public static function array(): array
 {
 return array_combine(static::names(), static::values());
 }
}

trait EnumJsonSerializableTrait
{
 use EnumArraySerializableTrait;
 
 public static function jsonSerialize(): string
 {
 return json_encode(static::array());
 }
}

enum Suit: string
{
 case Clubs = '♣';
 case Diamonds = '♦';
 case Hearts = '♥';
 case Spades = '♠';
 
 use EnumJsonSerializableTrait;
 
 public const DEFAULT = self::Hearts;
 
 public static function default(): static
 {
 return self::DEFAULT;
 }
}

var_dump(
 Suit::cases(),
 Suit::values(), 
 Suit::names(),
 Suit::array(),
 Suit::jsonSerialize(),
 Suit::default(),
);