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() 判断，而不是让整个架构变简单。
立即学习“PHP免费学习笔记（深入）”；
