PHP从8.0开始支持注解式属性，通过定义带#[Attribute]的类并应用于方法或类，结合反射API读取元数据，实现如路由分发等功能，提升代码可维护性与扩展性。
如果您在编写PHP代码时希望为类、方法或属性添加元数据信息，以便在运行时进行反射处理，则可以使用PHP注解。注解提供了一种结构化的方式来附加额外信息，而无需侵入业务逻辑。
本文运行环境：MacBook Pro，macOS Sonoma
一、启用PHP注解支持
PHP从8.0版本开始引入了对属性（Attributes）的支持，这相当于其他语言中的注解功能。要使用该特性，必须确保PHP版本不低于8.0，并且在项目中正确声明命名空间和类的使用方式。
1、检查当前PHP版本是否为8.0或更高，可通过命令行执行 php -v 查看。
立即学习“PHP免费学习笔记（深入）”；
2、在代码文件顶部声明严格类型模式，推荐加入 declare(strict_types=1); 以增强类型安全。
3、确认扩展未禁用反射相关功能，特别是 ReflectionAttribute 类可被正常使用。
二、定义自定义注解类
在PHP中，注解是通过创建带有 #[Attribute] 属性的类来实现的。此类用于标识哪些PHP元素可以应用该注解，并控制其作用范围。
1、创建一个新类文件，例如 Route.php，并在其中定义基本结构。
2、在类上方添加 #[Attribute(Attribute::TARGET_METHOD)] 表示此注解只能应用于方法。
3、可在类内部定义构造函数参数，用于接收注解传入的数据，如路径或权限等级。
4、保存文件并确保自动加载机制（如Composer）能正确加载该类。
三、在代码中应用注解
定义好注解类后，可以在具体的类方法或属性上使用它，从而附加元数据信息，供后续程序读取和处理。
1、在目标方法上方使用 #[Route("/api/users")] 的语法格式插入注解。
2、若注解类接受参数，可以直接在括号内传递值，支持字符串、数组、常量等类型。
3、多个注解可叠加使用，每行放置一个注解标签，提升代码可读性。
4、注意避免在不支持的目标上使用注解，否则会抛出编译错误。
四、通过反射读取注解信息
利用PHP的反射API可以在运行时动态获取类、方法或属性上的注解实例及其数据，这是实现路由分发、权限校验等功能的基础。
1、创建 ReflectionMethod 实例，指向需要分析的方法。
2、调用 getAttributes() 方法获取所有已应用的注解对象。
3、遍历返回的属性数组，使用 newInstance() 创建实际的注解类实例。
4、访问实例的公共属性或方法，提取之前设置的配置信息用于业务判断。
五、使用内置注解简化开发
部分现代PHP框架（如Symfony、Laravel结合第三方库）提供了预定义的注解类，用于控制器路由、数据库映射等场景，减少手动配置工作量。
1、安装支持注解的组件包，例如 symfony/attribute 或 doctrine/annotations。
2、引入相应的命名空间，如 use Symfony\Component\Routing\Annotation\Route;。
3、按照框架文档规范，在控制器方法上标注对应的注解指令。
4、启动应用服务后，框架会自动扫描并注册带注解的路由或服务定义。
