patr1k/phenum

PHP 枚举器

v1.0 2018-10-11 19:22 UTC

This package is auto-updated.

Last update: 2024-09-12 08:31:17 UTC


README

工作原理

与大多数使用抽象类作为域容器的枚举器不同,Phenum 是一个特质,可以附加到任何将枚举域表示为常量的类。

优点

  • 通过使用标量常量而不是对象来表示枚举,这种方法比基于对象的方法稍微快一些,并且更节省内存。
  • 枚举与它们所属的类耦合得更紧密,这可以使新手更容易阅读你的项目代码。

缺点

  • 没有使用对象来表示枚举,你的 IDE 的自动补全功能将不知道给定域的可能枚举值。你需要知道哪个类定义了域值,然后开始输入域前缀以查看可能值。
<?php
use Patr1k\Phenum;

class Person {
    use Phenum\Enum;
    
    /**
     * @var string
     */
    protected $gender;
    
    const GENDER_MALE        = 'M';
    const GENDER_FEMALE      = 'F';
    const GENDER_UNSPECIFIED = 'U';
    
    /**
     * @return string
     */
    public function getGender() {
        return $this->gender;
    }
    
    /**
     * @param  string $gender
     * @throws Phenum\DomainException
     */
    public function setGender($gender) {
        $this->gender = self::validateEnum($gender, 'GENDER');
    }
}

要求

  • PHP >= 5.6.0

许可证

MIT 许可证 见 LICENSE 文件