PHP8.4依赖注入教程及DI容器解析

有志者，事竟成！如果你在学习文章，那么本文《PHP8.4依赖注入实现教程及DI容器详解》，就很适合你！文章讲解的知识点主要包括，若是你对本文感兴趣，或者是想搞懂其中某个知识点，就请你继续往下看吧~

PHP 8.4 不内置 DI 容器，需手动实现；可利用 Attributes 和增强反射（如 ReflectionParameter::getType）实现类型安全的自动构造注入，但需 strict_types=1、避免 builtin 类型、手动处理联合类型与循环依赖，并用 WeakMap 缓存实例。

PHP 8.4 里没有内置 DI 容器

PHP 8.4 本身不提供 DependencyInjectionContainer 或类似 ContainerInterface 的标准实现。它只是语言版本，不包含框架级组件。所谓“PHP 8.4 实现依赖注入”，实际是指：在 PHP 8.4 环境下，用原生代码或轻量库手写一个符合现代 PHP 特性的 DI 容器。

用 #[\Attribute] + Reflection 实现自动构造注入

PHP 8.4 支持完整的 Attributes 和改进的反射 API（如 ReflectionParameter::getType() 更可靠），可以安全地做类型驱动的自动解析。关键不是“支持 DI”，而是“让自动注入更稳、更少报错”。

• 必须启用 declare(strict_types=1);，否则 ReflectionParameter::getType() 可能返回 null 即使有类型声明
• 只处理类名完整、非 self/static/parent 的类型提示；匿名类、联合类型（如 A|B）需手动配置，不能自动推导
• 循环依赖检测必须显式实现，PHP 不会帮你抛 CircularReferenceException
• 建议用 WeakMap 缓存已实例化的对象，避免重复构建和内存泄漏

final class Container
{
    private WeakMap $instances;
    private array $definitions = [];

    public function __construct() {
        $this->instances = new WeakMap();
    }

    public function set(string $id, callable $factory): void {
        $this->definitions[$id] = $factory;
    }

    public function get(string $id): mixed {
        if (isset($this->instances[$id])) {
            return $this->instances[$id];
        }

        if (!isset($this->definitions[$id])) {
            return $this->build($id);
        }

        $instance = ($this->definitions[$id])($this);
        $this->instances[$id] = $instance;

        return $instance;
    }

    private function build(string $className): object {
        $ref = new ReflectionClass($className);
        $constructor = $ref->getConstructor();

        if (!$constructor) {
            return $ref->newInstance();
        }

        $args = [];
        foreach ($constructor->getParameters() as $param) {
            $type = $param->getType();
            if (!$type || $type->isBuiltin()) {
                throw new InvalidArgumentException("Cannot auto-resolve builtin type for {$param->name} in {$className}");
            }
            $args[] = $this->get($type->getName());
        }

        return $ref->newInstanceArgs($args);
    }
}

__invoke 和 new 混用时容易踩的坑

很多教程直接用 $container($className) 代替 $container->get()，但 PHP 8.4 中若容器类实现了 __invoke，又同时被当作 callable 注入（比如传给 array_map），就可能意外触发构建逻辑，导致不该实例化的类被初始化。

• 不要让容器同时实现 __invoke 和可被 is_callable() 判定为 true 的行为，除非你明确控制所有调用上下文
• 注册服务时，避免用闭包直接捕获 $this —— PHP 8.4 的 GC 对闭包引用更敏感，容易延迟释放容器自身
• 如果用了 ReturnTypeWillChange 属性（兼容旧扩展），注意某些反射操作可能绕过严格类型检查，导致 get() 返回错误实例

别把“PHP 8.4”当银弹，DI 的复杂点不在语法

真正卡住人的从来不是属性怎么写、反射怎么调，而是服务生命周期管理：单例/原型/请求作用域怎么隔离？配置如何分环境加载？AOP 织入点怎么跟容器联动？这些在 PHP 8.4 里依然得自己搭骨架。语法糖只是让 build() 少几行 is_null() 判断，而不是让整个架构变简单。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~