学过java的同学应该都知道注解的作用，但是在php中注解有什么用呢？我的理解就是美化代码和便于维护一些类的设计。

说明

我们先设计一个类，声明人类的性别

1. <?php 
2. class Sex 
3. { 
4.     //男人 
5.     const MAN = 1; 
6.       
7.     //女人 
8.     const WIFE = 2; 
9.  
10.     //未知 
11.     const UNKNOWN = 0; 
12. } 

由上可知，我们分别设计了3个类型，0=>未知，1=>男人，2=>女人

现在，应业务需求，我给前端展示的内容不能显示数字（0，1，2），要展示汉字（未知，男人，女人），数据映射在后端完成。 结合php8引入了枚举的支持。那么我们重新设计如下

1. <?php 
2.  
3. enum Sex : int 
4. { 
5.     //男人 
6.     case MAN = 1; 
7.       
8.     //女人 
9.     case WIFE = 2; 
10.  
11.     //未知 
12.     case UNKNOWN = 0; 
13.       
14.     public function getDescription() : string 
15.     { 
16.         return match($this) 
17.         { 
18.             self::MAN   =>   '男人', 
19.             self::WIFE  =>  '女人', 
20.             self::UNKNOWN => '未知' 
21.         }; 
22.     } 
23. } 
24. echo Sex::MAN->getDescription(); //获得中文映射 

由上可知，是不是看着就简单了许多。

但是，还有更直观的显示，设计会稍微复杂一点，我们接着慢慢向下看。

我们先设计一个trait，此trait完成注解的反射。

1. <?php 
2. trait EnumFeature 
3. { 
4.      /** 
5.       * 获取case 注解内容 
6.       * @param string $class 注解类 
7.       * @return null | Object 
8.       */ 
9.      protected function getTargetCaseReflectionAnnotation(string $class) : mixed 
10.      { 
11.         $reflection = new \ReflectionEnumBackedCase(self::class,$this->name); 
12.  
13.         $attributes = $reflection->getAttributes(); 
14.         if(emptyempty($attributes)) 
15.         { 
16.             return null; 
17.         } 
18.  
19.         foreach($attributes as $attribute) 
20.         { 
21.             if($attribute->getName() === $class) 
22.             { 
23.                 return $attribute->newInstance(); 
24.             } 
25.         } 
26.  
27.         return null; 
28.      } 
29. } 

在设计一个注解类，让这个注解类可以注解 enum - case

1. <?php 
2. #[\Attribute(\Attribute::TARGET_CLASS_CONSTANT)] 
3. class CaseDescription 
4. { 
5.     public function __construct( 
6.         public string $description 
7.     ){} 
8. } 

重构 enum 设计如下

1. enum Sex : int 
2. { 
3.     use EnumFeature 
4.       
5.     #[CaseDescription('男人')] 
6.     case MAN = 1; 
7.       
8.     #[CaseDescription('女人')] 
9.     case WIFE = 2; 
10.  
11.     #[CaseDescription('未知')] 
12.     case UNKNOWN = 0; 
13.       
14.     public function getDescription() : ?string 
15.     { 
16.         //获取注解示例，并从中获取 description 属性 
17.         return $this->getTargetCaseReflectionAnnotation(CaseDescription::class)?->description; 
18.     } 
19. } 

这样看着是否直观了很多？对比之前的方案，也便于维护。

完整版，应业务需求，不同的性别在页面上呈现的性别颜色也不同。

再设计一个Color注解

1. <?php 
2.  
3. #[\Attribute(\Attribute::TARGET_ALL)] 
4. class Color 
5. { 
6.     public function __construct( 
7.         public ?string $value = null 
8.     ){} 
9. } 

对性别进行color注解添加

1. enum Sex : int 
2. { 
3.     use EnumFeature 
4.       
5.     #[CaseDescription('男人'),Color("#000000")] 
6.     case MAN = 1; 
7.       
8.     #[CaseDescription('女人'),Color("#FFF000")] 
9.     case WIFE = 2; 
10.  
11.     #[CaseDescription('未知'),Color("#CCCCCC")] 
12.     case UNKNOWN = 0; 
13.       
14.     //获取中文名称 
15.     public function getDescription() : ?string 
16.     { 
17.         //获取注解示例，并从中获取 description 属性 
18.         return $this->getTargetCaseReflectionAnnotation(CaseDescription::class)?->description; 
19.     } 
20.       
21.     //获取颜色 
22.     public function getColort() : ?string 
23.     { 
24.         return $this->getTargetCaseReflectionAnnotation(Color::class)?->value; 
25.     } 
26. } 

以上就是我对注解的实际应用。当然再hyperf 框架中，注解实际上被赋予了更多的含义（如自动注入等高级功能，类似java的spring容器了）

总结

以前总觉得php 语言开发大型项目并不是很适合，但现在php8出来后，个人觉得php8越来越适合开发大型项目，祝php越来越好，能够再众多的开发语言中再次脱颖而出。php是世界上最好的语言~

Tags: php8实际应用

分享到：