Hyperf 的 DI 容器通过绑定规则、解析逻辑、生命周期控制和注解支持四方面实现可扩展性：可在 dependencies.php 中扩展接口绑定、单例/工厂绑定与条件绑定；通过 DefinitionInterface 自定义解析逻辑；继承 ScopeInterface 扩展作用域类型；定义属性注解及处理器实现注解驱动注入。
Hyperf 的核心容器（即 DI 容器）不是封闭黑盒，而是高度可扩展的。它的扩展不依赖“魔改源码”，而是围绕绑定规则、解析逻辑、生命周期控制和注解支持四个关键点展开。只要理解容器的注册与解析机制，就能安全、清晰地注入新能力。
绑定层扩展：接管接口与实现的映射关系
容器启动时会加载 config/autoload/dependencies.php，这个文件返回的数组就是初始绑定表。你可以在这里做三类扩展：
-
接口绑定具体类：例如将
UserRepositoryInterface::class绑定到DatabaseUserRepository::class，后续所有构造函数或#[Inject]中声明该接口的地方，自动获得数据库实现 -
单例/工厂绑定：用
$container->singleton()或$container->factory()注册复杂对象，比如带配置参数的缓存客户端 - 条件绑定：在 ConfigProvider 中根据环境变量或配置开关动态决定绑定哪个实现，实现开发/测试/生产多套策略
解析层扩展：自定义对象创建逻辑
默认情况下，容器靠反射自动解析构造函数参数。但某些类无法直接 new（如需要连接池管理的 Redis 实例），这时可通过 DefinitionSource 或 ResolverDispatcher 插入自定义解析器：
- 实现
Hyperf\Di\Definition\DefinitionInterface，定义自己的实例化流程（例如从连接池取连接、设置超时） - 在
ConfigProvider::getDependencies()中注册该定义，让容器在遇到特定类时走你的逻辑 - 适用于封装第三方 SDK、适配旧有单例类、或统一处理资源初始化失败重试等场景
生命周期扩展：支持新作用域类型
Hyperf 原生支持 singleton、request-scoped、prototype 三种作用域。若业务需要“协程级单例”或“任务队列内单例”，可扩展作用域管理器：
- 继承
Hyperf\Di\Scope\ScopeInterface，实现get()和set()方法，底层可基于Co::getContext()或Channel存储实例 - 在容器初始化阶段通过
$container->setScopeManager()替换默认管理器（需在Bootstrap阶段完成） - 配合自定义注解（如
#[CoroutineScoped]）使用，保持语义清晰
注解驱动扩展：新增注入能力
Hyperf 的 #[Inject] 背后是一整套注解扫描+属性注入流程。要支持新注解（比如 #[Config("app.name")] 直接注入配置值），需：
- 定义 PHP 8 属性类，如
#[Attribute(Attribute::TARGET_PROPERTY)] class Config { public function __construct(public string $key) {} } - 编写注解处理器，继承
Hyperf\Di\Annotation\AbstractAnnotation，重写collectProperty()方法，在其中读取配置并设置属性值 - 在
ConfigProvider::getAnnotations()中注册该处理器，容器启动时自动启用
整个过程不侵入框架核心，所有扩展都通过配置、接口实现和标准注解机制完成，既稳定又利于升级维护。
