PHP 8.1引入的枚举（Enum）为定义固定集合的类型提供了原生支持，在实际开发中，多个枚举往往需要实现相同的方法逻辑，比如获取枚举描述、根据值查找枚举实例等。如果为每个枚举单独编写这些方法，会产生大量重复代码，而Trait可以很好地解决这个问题，实现枚举方法的跨枚举复用。
Trait与枚举结合的基础用法
首先我们需要定义一个包含通用方法的Trait，然后在多个枚举中引入这个Trait即可。下面是一个简单的示例，实现枚举描述信息的复用。
<?php
// 定义包含通用方法的Trait
trait EnumDescriptionTrait
{
// 获取枚举的描述信息，假设枚举case的注释中包含描述
public function getDescription(): string
{
$reflection = new ReflectionEnumUnitCase($this, $this->name);
$docComment = $reflection->getDocComment();
if ($docComment) {
// 提取注释中的描述内容
preg_match('//**s*(.*?)s**//s', $docComment, $matches);
return $matches[1] ?? $this->name;
}
return $this->name;
}
// 根据枚举值获取对应的枚举实例
public static function fromValue(mixed $value): static
{
foreach (self::cases() as $case) {
if ($case->value === $value) {
return $case;
}
}
throw new InvalidArgumentException("无效的枚举值: $value");
}
}
// 第一个枚举引入Trait
enum UserStatus: int
{
use EnumDescriptionTrait;
/** 正常状态 */
case NORMAL = 1;
/** 禁用状态 */
case DISABLED = 2;
/** 待审核状态 */
case PENDING = 3;
}
// 第二个枚举引入同一个Trait
enum OrderStatus: string
{
use EnumDescriptionTrait;
/** 待支付 */
case UNPAID = 'unpaid';
/** 已支付 */
case PAID = 'paid';
/** 已发货 */
case SHIPPED = 'shipped';
}
// 使用示例
$userStatus = UserStatus::NORMAL;
echo $userStatus->getDescription(); // 输出：正常状态
$orderStatus = OrderStatus::fromValue('paid');
echo $orderStatus->getDescription(); // 输出：已支付
Trait中处理枚举的特有属性
枚举除了普通方法外，还支持定义__call等魔术方法，也可以结合枚举的value属性实现更复杂的逻辑。下面的示例展示Trait中处理枚举值的通用逻辑。
<?php
trait EnumValueTrait
{
// 判断当前枚举值是否在指定数组中
public function in(array $values): bool
{
return in_array($this->value, $values);
}
// 获取所有枚举值的数组
public static function values(): array
{
return array_map(fn ($case) => $case->value, self::cases());
}
}
enum ProductType: string
{
use EnumValueTrait;
case ELECTRONICS = 'electronics';
case CLOTHING = 'clothing';
case BOOKS = 'books';
}
// 使用示例
$type = ProductType::ELECTRONICS;
var_dump($type->in(['electronics', 'clothing'])); // 输出：bool(true)
var_dump(ProductType::values()); // 输出：array(3) { [0]=>string(11) "electronics" [1]=>string(8) "clothing" [2]=>string(5) "books" }
注意事项
- Trait中不能直接访问枚举的私有属性，如果需要访问枚举的私有成员，需要在枚举中提供对应的公共访问方法。
- 如果多个Trait和枚举自身都定义了同名方法，枚举自身的方法优先级最高，其次是Trait中的方法，如果存在多个Trait有同名方法，需要通过
insteadof关键字解决冲突。 - 枚举引入Trait后，Trait中的方法会被枚举实例直接调用，使用方式和枚举自身定义的方法完全一致。
适用场景
这种方式非常适合多个枚举需要共享相同工具方法的场景，比如通用的枚举值校验、枚举描述获取、枚举列表转换等逻辑，都可以抽成Trait复用，避免重复代码，后续如果需要修改通用逻辑，只需要修改Trait中的代码即可，所有引入该Trait的枚举都会生效，大幅降低维护成本。