Hyperf核心注解怎么应用_Hyperf注解驱动开发方法【教程】-php教程-PHP中文网

Hyperf 注解是基于 PHPDoc 的元编程机制，需配合 AOP 与扫描生效；核心注解包括 @Controller、@GetMapping、@Inject 等；自定义注解需定义类、编写处理器并注册；调试时需检查扫描路径、PHPDoc 格式及代理类生成。

hyperf核心注解怎么应用_hyperf注解驱动开发方法【教程】

Hyperf 的注解（Annotation）是其核心特性之一，本质是通过 PHPDoc 注释 + 自定义解析器实现的元编程机制，用于声明式地配置路由、注入依赖、定义中间件、管理生命周期等。它不改变 PHP 语法，但极大提升了开发效率和代码可读性。

Hyperf 默认启用注解驱动，但前提是：

项目已正确安装 hyperf/annotation 组件（通常随 hyperf/framework 自动引入）
config/autoload/annotations.php 中配置了需要扫描的命名空间路径（如 App\Controller、App\Service）
启动时执行了注解扫描（Hyperf 在 Di\ClassLoader 中自动完成，无需手动调用）
类文件需使用 /** */ 标准 PHPDoc，且注解类已正确导入（如 use Hyperf\HttpServer\Annotation\GetMapping;）

以下是最常被使用的几类注解，直接对应关键开发场景：

Hyperframes Creative

HyperFrames视频非动画创意指导，包括设计规范（frame.md/design.md）处理、配色、字体设计、旁白及节奏规划等。

下载

@Controller：标记控制器类，自动注册为容器对象，并启用路由扫描。可选参数 prefix 设置统一前缀，例如：
#[Controller(prefix: "/api/user")]
@GetMapping / @PostMapping / @RequestMapping：绑定 HTTP 方法与路径，支持路径变量（{id}）和正则约束（{id:\d+}），例如：
#[GetMapping("/info/{id:\d+}")]
@Inject：属性注入依赖，替代 $container->get() 或构造函数注入。支持类型提示自动推导，例如：
#[Inject] private UserService $userService;
@Middleware：为方法或类添加中间件，支持全局、分组、单接口粒度控制，例如：
#[Middleware(AuthMiddleware::class)]
@Value：从配置中心（config/autoload/）注入值，支持点号路径，例如：
#[Value("app.name")] private string $appName;

当内置注解不够用时，可快速扩展自己的注解：

定义注解类：创建在 App\Annotation 下，继承 Hyperf\Di\Annotation\AbstractAnnotation，设置 $name 属性作为标签名
编写处理器（Aspect）：实现 Hyperf\Di\Aop\AroundInterface 或 Hyperf\Di\Aop\PointExecutionInterface，在 process() 中读取注解元数据并执行逻辑
注册到容器：在 config/autoload/annotations.php 的 scan → paths 中加入自定义注解路径，并在 aspects 数组中注册对应的 Aspect 类