PHP依赖注入：PHP-DI容器配置

理解依赖注入与 PHP-DI 容器

依赖注入（DI）与控制反转（IoC）是现代软件架构的核心思想。IoC 强调将对象的创建与依赖管理权从类内部转移到外部，而 DI 则是实现 IoC 的具体手段，即通过构造函数或 Setter 将依赖对象传入，而非在类内部硬编码实例化。服务容器则是承载这一机制的运行环境，负责统一管理对象的生命周期与依赖关系。PHP-DI 正是为 PHP 生态打造的轻量级容器，它解决了传统开发中手动 new 对象导致的强耦合、难以测试和重复实例化问题。在实际应用中，当控制器需要调用业务服务，而服务又依赖数据访问层时，PHP-DI 会接管整个依赖链。容器首先扫描配置或启用自动装配，递归解析每个类所需的依赖，按需创建实例并注入，最终返回完全就绪的根对象。这一流程不仅降低了模块间的耦合度，还为后续的单元测试和架构演进提供了坚实基础。

安装 PHP-DI 并配置容器

在项目中引入 PHP-DI 的第一步是通过 Composer 进行安装。在项目根目录执行 composer require php-di/php-di 命令后，依赖包及其所需的 PSR-11 接口将被自动下载至 vendor 目录。安装完成后，开发者需创建容器实例并加载依赖定义文件。通常建议在项目入口文件中初始化容器：首先引入 Composer 自动加载器，随后实例化 DI\ContainerBuilder，并通过 addDefinitions() 方法指定配置文件路径。PHP-DI 支持 PHP 数组或 PHP 文件作为定义源，例如创建一个 config/container.php 文件，在其中返回包含类映射、接口绑定和标量参数的关联数组。容器构建器会读取该配置，结合缓存机制编译出最终的 Container 对象。这种配置加载方式将依赖声明与业务逻辑彻底分离，使得后续维护只需修改配置文件即可调整服务实现，无需触碰核心代码。

配置接口绑定与自动注入

PHP-DI 的核心优势在于强大的接口绑定与自动装配能力。在配置文件中，开发者可以使用 \DI\autowire() 或 \DI\create() 将接口映射到具体实现类。例如，定义 App\Contracts\CacheInterface 指向 App\Services\RedisCache 后，容器在解析依赖时会自动识别该映射。当某个服务类的构造函数声明了 CacheInterface 类型提示时，PHP-DI 会启用 Autowiring 机制，自动实例化 RedisCache 并注入。若实现类自身还依赖其他服务，容器会沿依赖链递归解析，全程无需手动编写工厂代码。对于需要显式指定参数的场景，可使用 \DI\get() 引用已注册服务，或通过 \DI\env() 读取环境变量。这种基于接口编程的模式彻底解耦了调用方与实现方，后续只需替换配置文件中的绑定目标，即可无缝切换至其他缓存实现，极大提升了系统的可扩展性与可测试性。

运行验证与常见配置避坑

配置完成后，必须通过实际调用验证容器是否按预期工作。在入口脚本中调用 $container->get('App\Services\OrderService')，若返回对象且内部依赖已正确注入，则说明配置生效。然而在实际开发中，常会遇到几类典型错误。首先是接口未绑定或命名空间拼写错误，导致容器抛出 InvalidDefinition 异常；其次是配置文件路径错误或未正确调用 addDefinitions()，使容器退化为纯自动装配模式，无法识别自定义映射。第三是循环依赖，例如 A 依赖 B，B 又依赖 A，容器在递归解析时会陷入死循环并抛出 CircularDependencyException，此时需引入事件总线或延迟注入打破闭环。此外，标量参数未通过 \DI\value() 包装会被误认为类名，以及在不同请求中重复实例化容器导致内存泄漏与状态不一致，都是需要严格规避的陷阱。建议开启调试模式并配合日志记录，快速定位配置断点。