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 ¶

11 个月前

其他用例示例
<?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(),
);