Hyperf 的核心架构是基于常驻内存、协程驱动、组件化与依赖注入的分层设计,依托 Swoole/Swow 实现高性能微服务;内置 DI 容器、注解驱动 AOP、可插拔分层组件、事件与中间件机制。

Hyperf 的核心架构是基于常驻内存、协程驱动、组件化与依赖注入的分层设计,不是传统 PHP-FPM 的“请求-响应”短生命周期模型,而是启动即长期运行的服务进程。它依托 Swoole 或 Swow 提供的协程能力,实现高性能、高并发、低延迟的微服务开发体验。
常驻内存 + 协程运行时
Hyperf 启动后,会创建一个常驻内存的服务器进程(HTTP/TCP/WebSocket),所有请求都在该进程中协程化处理。协程由 Swoole 调度,轻量、免系统线程切换,IO 操作(如数据库查询、Redis 调用、HTTP 请求)自动挂起与恢复,代码保持同步写法,但底层完全异步非阻塞。
- 协程上下文(Context)隔离各请求的数据,避免变量污染
- 连接池(Database、Redis、HTTP Client)复用底层连接,减少握手开销
- 无需回调地狱,也无需 await/async 关键字(PHP 原生不支持),协程调度对开发者透明
依赖注入容器(DI Container)
这是 Hyperf 的中枢神经,所有组件、服务、控制器都通过它管理生命周期和依赖关系。它遵循 PSR-11 标准,支持自动注入、注解绑定(@Inject)、单例/原型模式、懒加载代理和工厂构造。
- 容器在服务启动时初始化,全程常驻,不随请求重建
- 与注解系统深度集成,比如 @Controller 类被自动注册为容器服务
- AOP 切面、事件监听器、中间件等均依赖 DI 容器完成织入与执行
注解驱动 + AOP 面向切面编程
Hyperf 大量使用 PHP 8 Attributes(或 Doctrine 注解)声明行为,把配置逻辑从代码中剥离,实现声明式开发。
- 路由:@RequestMapping、@AutoController
- 缓存:@Cacheable、@CacheEvict
- AOP:@Aspect + @Around 实现日志、权限、事务等横切逻辑
- 配置注入:@Value("app.name") 直接读取配置项
分层组件体系
Hyperf 不是“大而全”的单体框架,而是按职责拆分为可插拔的独立组件,通过 Composer 管理依赖,按需引入:
- 网络层:HTTP Server、WebSocket、gRPC、JSON-RPC 支持
- 数据层:协程化 Database(Eloquent 兼容)、Redis、ETCD 客户端
- 异步层:Async Queue(Redis/DB/AMQP 驱动)、定时任务(Crontab)
- 微服务层:服务注册发现(Nacos/Apollo/Etcd)、负载均衡、熔断限流
- 可观测层:OpenTelemetry 集成、Grafana 监控仪表盘、Whoops 异常调试界面
事件与中间件机制
事件系统采用观察者模式,支持自定义事件触发与监听;中间件则沿用经典的“洋葱模型”,请求进入和响应返回时依次经过各层中间件,适合做鉴权、日志、CORS 等通用逻辑。
- 事件可跨服务广播,配合消息队列实现松耦合通信
- 中间件支持全局、路由级、控制器级多粒度配置
- 两者都通过 DI 容器管理,可直接注入其他服务










