依赖注入本质是外部传入依赖而非类内new,核心为构造函数注入与接口抽象;需避免构造函数耗时、null默认值及字符串判断,优先用PHP-DI等成熟容器并显式绑定第三方类,强调类型提示与接口解耦。

PHP 依赖注入不是“用不用”的问题,是“怎么让类不自己 new 东西”
依赖注入的本质,是把一个类需要的外部对象(比如数据库连接、日志器)从外部传进来,而不是在类内部用 new 硬编码创建。不这么做,测试难、替换难、耦合死——尤其当你要换掉 PDO 改用 mysqli,或者把 FileLogger 换成 SlackLogger 时,就得改一堆 new。
实操上,最轻量的方式就是构造函数注入:
$db = new PDO($dsn, $user, $pass);
$logger = new FileLogger('/var/log/app.log');
$service = new UserService($db, $logger); // 依赖由外部传入
注意:别在构造函数里做耗时操作(比如连数据库),否则容器预热或反射实例化时会卡住;也别传 null 或留默认参数假装“可选”,那其实是逃避设计问题。
PHP 容器不是必须写个“ServiceContainer”类
真要手写容器,核心就两件事:注册(set)和解析(get)。但绝大多数项目不需要从零造轮子——PHP-DI 或 symfony/dependency-injection 已经覆盖 95% 场景。它们能自动解析构造函数参数类型提示,自动递归注入依赖链。
常见错误现象:Entry "App\Service\UserService" cannot be resolved: Entry "PDO" cannot be resolved。这是因为容器不知道怎么创建 PDO,你得显式告诉它:
$container->set(PDO::class)->factory(function () use ($config) {
return new PDO($config['dsn'], $config['user'], $config['pass']);
});
- 别用
instanceof或字符串类名做条件判断来决定返回哪个实例,该用接口绑定(set(LoggerInterface::class)->to(FileLogger::class)) - 开发环境用自动发现(
autowire),生产环境关掉,避免反射开销和意外加载 -
shared(单例)和notShared(每次新建)必须按需选:数据库连接通常共享,请求上下文对象必须不共享
类型提示 + 接口才是依赖注入能跑起来的前提
如果类构造函数写的是 function __construct(PDO $pdo),容器才能靠反射知道要塞个 PDO 实例进去。一旦写成 function __construct($pdo),容器就只能瞎猜或报错。
更关键的是接口抽象:
interface CacheInterface { public function get(string $key); }
class RedisCache implements CacheInterface { /* ... */ }
class ArrayCache implements CacheInterface { /* ... */ }
这样你就能在容器里灵活切换实现,而所有用到 CacheInterface 的类完全无感:
$container->set(CacheInterface::class)->to(RedisCache::class); // 切 Redis // 或 $container->set(CacheInterface::class)->to(ArrayCache::class); // 切内存
- 别给接口起
ICache这种带前缀的名字,PHP 不需要;就叫CacheInterface - 别为了“看起来像 DI”而强行加接口——只有真正存在多实现、且需要运行时切换的地方才抽接口
- 第三方类(如
PDO)没有接口?那就封装一层薄适配器,别直接往构造函数里塞PDO类名
自动注入在 CLI 和 Web 请求中表现不同
Web 请求生命周期短,容器通常每次请求重建一次;CLI 命令(比如 php bin/console user:sync)可能长时运行,若用了共享实例又没清理状态(比如缓存、连接),第二次调用就可能出错。
典型坑:
-
PDO实例被设为 shared,但某次查询后beginTransaction()没commit或rollback,下一次请求复用这个连接就卡死 - 容器里绑了
DateTimeImmutable实例并设为 shared,结果所有地方拿到的都是同一秒的时间戳 - 使用
symfony/console时,命令类本身由容器创建,但它的execute()方法里手动new的对象不会被自动注入,得显式从$this->getApplication()->getContainer()拿
复杂点在于:依赖图越深,初始化顺序越敏感;而 PHP 没有真正的模块生命周期管理,容器配置散落在多个文件时,加载顺序一错,get() 就抛异常。这时候别硬调,先用 container->debug()(PHP-DI)或 debug:container(Symfony)看实际注册了啥。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











