今天來分享下如何管理 PHP 的枚舉類型。
一種常見的方式是,使用常量來代表枚舉類型
const YES = '是';
const NO = '否';
可以在這個(gè)基礎(chǔ)上更進(jìn)一步,將其封裝成類,以便于管理
class BoolEnum {
const YES = '是';
const NO = '否';
}
現(xiàn)在,我們希望能通過方法來動(dòng)態(tài)調(diào)用對(duì)應(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();
// 返回對(duì)應(yīng)的常量
return $contants;
}
// 動(dòng)態(tài)調(diào)用屬性
public static function __callStatic($name, $arguments)
{
$arr = static::toArray();
if(isset($arr[$name])){
return $arr[$name];
}
throw new \BadMethodCallException("找不到對(duì)應(yīng)的枚舉值 {$name}");
}
}
class BoolEnum extends Enum
{
const YES = '是';
const NO = '否';
}
利用反射,可以獲取到所有的枚舉類型。同時(shí),利用魔術(shù)方法則可以實(shí)現(xiàn)對(duì)屬性的動(dòng)態(tài)調(diào)用。這里要注意的是,反射會(huì)消耗較多的資源,因此,對(duì) toArray 方法進(jìn)行重構(gòu),增加一個(gè)緩存變量來緩存獲取到的枚舉類型,避免重復(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)在考慮更多的使用場(chǎng)景,比如用實(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í)例對(duì)應(yīng)的鍵
public function getKey(){
return array_search($this->value, static::toArray(), true);
}
// 獲取實(shí)例對(duì)應(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 = '非法值'; // 可能不會(huì)報(bào)錯(cuò)
$yes = new BoolEnum("非法值"); // 將會(huì)拋出異常
$user->banned = $yes;
或者作為參數(shù)類型限定
function setUserStatus(BoolEnum $boolEnum){
$user->banned = $boolEnum;
}
PHP 作為一門弱類型語言,參數(shù)限定的不足會(huì)導(dǎo)致很多不可預(yù)期的錯(cuò)誤發(fā)生,通過使用枚舉類,我們進(jìn)一步加強(qiáng)了參數(shù)限定的功能,同時(shí),管理枚舉類型也更加的方便統(tǒng)一。
以上就是本次介紹的全部相關(guān)知識(shí)點(diǎn),感謝大家的學(xué)習(xí)和對(duì)腳本之家的支持。