關(guān)于PHP枚舉類型的管理與設(shè)計(jì)介紹

這篇文章主要為大家詳細(xì)介紹了關(guān)于PHP枚舉類型的管理與設(shè)計(jì)介紹，文中示例代碼介紹的非常詳細(xì)，具有一定的參考價值，感興趣的小伙伴們可以參考一下。

本文的實(shí)現(xiàn)主要是基于 myclabs/php-enum 擴(kuò)展包。

今天來分享下如何管理 PHP 的枚舉類型。

一種常見的方式是，使用常量來代表枚舉類型

const YES = '是';
const NO = '否';

可以在這個基礎(chǔ)上更進(jìn)一步，將其封裝成類，以便于管理

class BoolEnum {
    const YES = '是';
    const NO = '否';
}

現(xiàn)在，我們希望能通過方法來動態(tài)調(diào)用對應(yīng)的枚舉類型

BoolEnum::YES(); // 是
BoolEnum::NO(); // 否

也可以批量獲取枚舉類型

BoolEnum::toArray(); // ['Yes' => '是', 'No' => '否']

下面來實(shí)現(xiàn)上面列舉的功能。

定義基本的枚舉基類，讓所有的枚舉類都繼承該抽象基類。

abstract class Enum
{   
    // 獲取所有枚舉類型
    public static function toArray(){
        // 通過反射獲取常量
        $reflection = new \ReflectionClass(static::class);
        $contants = $reflection->getConstants();
        // 返回對應(yīng)的常量
        return $contants;
    }
    //  動態(tài)調(diào)用屬性
    public static function __callStatic($name, $arguments)
    {
        $arr = static::toArray();
        if(isset($arr[$name])){
            return $arr[$name];
        }
        throw new \BadMethodCallException("找不到對應(yīng)的枚舉值 {$name}");
    }
}
class BoolEnum extends Enum
{
    const YES = '是';
    const NO = '否';
}

利用反射，可以獲取到所有的枚舉類型。同時，利用魔術(shù)方法則可以實(shí)現(xiàn)對屬性的動態(tài)調(diào)用。這里要注意的是，反射會消耗較多的資源，因此，對 toArray 方法進(jìn)行重構(gòu)，增加一個緩存變量來緩存獲取到的枚舉類型，避免重復(fù)使用反射。

abstract class Enum
{   
    protected static $cache = [];
    public static function toArray(){
        $class = static::class;
        // 第一次獲取，就通過反射來獲取
        if(! isset(static::$cache[$class])){
            $reflection = new \ReflectionClass(static::class);
            static::$cache[$class] = $reflection->getConstants();
        }
        return static::$cache[$class];
    }
}

現(xiàn)在考慮更多的使用場景，比如用實(shí)例來代表特定枚舉類型

$yes = new BoolEnum("是");
echo $yes; // "是"

實(shí)現(xiàn)如下

abstract Enum 
{
    protected $value;
    public function __construct($value)
    {   
        if ($value instanceof static) {
            $value = $value->getValue();
        }
        if(! $this->isValid($value)){
            throw new \UnexpectedValueException("$value 不屬于該枚舉值" . static::class);
        }
        $this->value = $value;
    }
    // 獲取實(shí)例對應(yīng)的鍵
    public function getKey(){
        return array_search($this->value, static::toArray(), true);
    }
    // 獲取實(shí)例對應(yīng)的值
    public function getValue()
    {
        return $this->value;
    }
    // 允許字符串形式輸出
    public function __toString()
    {
        return $this->value;
    }
    // 驗(yàn)證值是否合法
    public function isValid($value)
    {
      $arr = static::toArray();
      return in_array($value, $arr, true);
    }
    // 驗(yàn)證鍵是否合法
    public function isValidKey($key)
    {
      $arr = static::toArray();
      return array_key_exists($key, $arr);
    }
}

這樣做可避免用戶使用非法的枚舉類型的值

$user->banned = '非法值';  // 可能不會報錯
$yes = new BoolEnum("非法值"); // 將會拋出異常
$user->banned = $yes;

或者作為參數(shù)類型限定

function setUserStatus(BoolEnum $boolEnum){
    $user->banned = $boolEnum;
}

PHP 作為一門弱類型語言，參數(shù)限定的不足會導(dǎo)致很多不可預(yù)期的錯誤發(fā)生，通過使用枚舉類，我們進(jìn)一步加強(qiáng)了參數(shù)限定的功能，同時，管理枚舉類型也更加的方便統(tǒng)一。

關(guān)于關(guān)于PHP枚舉類型的管理與設(shè)計(jì)介紹就分享到這里了，希望以上內(nèi)容可以對大家有一定的參考價值，可以學(xué)以致用。如果喜歡本篇文章，不妨把它分享出去讓更多的人看到。