示例 #1 值受限的基本用法
<?php
enum SortOrder
{
case ASC;
case DESC;
}
function query($fields, $filter, SortOrder $order = SortOrder::ASC) { ... }
?>
由于確保 $order 不是 SortOrder::ASC
就是 SortOrder::DESC，所以 query() 函數能安全處理。
因為其他任意值都會(huì )導致 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',
};
}
}
?>
這個(gè)例子中，用戶(hù)的狀態(tài)是 UserStatus::Pending、
UserStatus::Active、UserStatus::Suspended、
UserStatus::CanceledByUser 中的一個(gè)，具有獨占性。
函數可以根據 UserStatus 設置參數類(lèi)型，僅支持這四種值。
所有四個(gè)值都有一個(gè) label() 方法，返回了人類(lèi)可讀的字符串。
它獨立于等同于標量的“機器名”。
機器名用于類(lèi)似數據庫字段或 HTML 選擇框這樣的地方。
<?php
foreach (UserStatus::cases() as $case) {
printf('<option value="%s">%s</option>\n', $case->value, $case->label());
}
?>