示例 #1 值受限的基本用法
<?php
enum SortOrder
{
case ASC;
case DESC;
}
function query($fields, $filter, SortOrder $order = SortOrder::ASC) { ... }
?>
由于確保 $order 不是 SortOrder::ASC
就是 SortOrder::DESC，所以 query() 函數(shù)能安全處理。
因?yàn)槠渌我庵刀紩?huì)導(dǎo)致 TypeError，
所以不需要額外的錯(cuò)誤檢查。
示例 #2 值排他的高級(jí)用法
<?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',
};
}
}
?>
這個(gè)例子中，用戶的狀態(tài)是 UserStatus::Pending、
UserStatus::Active、UserStatus::Suspended、
UserStatus::CanceledByUser 中的一個(gè)，具有獨(dú)占性。
函數(shù)可以根據(jù) UserStatus 設(shè)置參數(shù)類型，僅支持這四種值。
所有四個(gè)值都有一個(gè) label() 方法，返回了人類可讀的字符串。
它獨(dú)立于等同于標(biāo)量的“機(jī)器名”。
機(jī)器名用于類似數(shù)據(jù)庫字段或 HTML 選擇框這樣的地方。
<?php
foreach (UserStatus::cases() as $case) {
printf('<option value="%s">%s</option>\n', $case->value, $case->label());
}
?>