06.5.2.2 容器与依赖注入
所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.2 ThinkPHP
本节要解决的问题
- 容器如何绑定、解析与复用对象实例,
bind/instance/make/invoke各用于什么场景? - 构造器与方法参数如何自动注入,标量参数与对象参数分别从哪里来?
- 如何通过容器替换实现、便于测试,容器与门面、助手函数是什么关系?
版本前提:ThinkPHP 6.x / 8.0;容器组件在 8.1.2 起独立为依赖,API 细节以当前版本手册与 vendor 源码为准。
06.5.2.2-001 容器解决什么问题?
一句话结论
容器统一管理对象实例及其依赖:对象不自己 new,声明所需类型由容器构造并注入;绑定关系可替换,便于解耦、复用与测试。
概念解释
容器是依赖注入的载体,按类名或标识维护绑定与已解析实例。消费方只依赖类型/接口,创建方式由容器决定,更换实现不改业务代码。
原理流程
- 在容器中登记绑定:类名、标识或接口到实现的映射。
- 解析时容器按绑定构造对象,递归注入其构造器依赖。
- 已解析实例按单例规则复用或按需重建。
- 消费方通过类型提示、门面或助手函数取用对象。
代码或图示
// 依赖容器:构造器声明类型,由容器注入
class OrderService
{
public function __construct(private \app\repository\OrderRepo $repo) {}
}
常见误区
- 业务类里手动
new依赖:绕过容器,无法替换也拿不到容器管理的其他依赖。 - 把容器当全局服务定位器到处
app()->xxx:依赖不显式,难以测试与审查。
追问
- 容器与 DI 容器是一回事吗?答:容器负责实例注册表与依赖解析,依赖注入是其使用方式,二者常一起出现。
- 不使用容器会怎样?答:对象创建硬编码在代码里,实现替换需改调用点,测试难以替身。
06.5.2.2-002 think\Container、think\App 与 app() 助手是什么关系?
一句话结论
容器工作由 think\Container 完成,think\App 复用容器能力;多数场景通过应用类或 app() 助手操作容器,app() 是容器解析的快捷入口。
概念解释
App 既是应用对象也是容器门面式入口,容器内对象可通过标识单例调用;未绑定时以类名作为容器标识。
原理流程
- 框架引导创建
App(内含容器实例)。 app('标识')从当前容器解析对应实例。- 直接使用
Container::getInstance()可拿到容器本体做底层操作。 - 门面底层也是从容器解析实例。
代码或图示
$repo = app(\app\repository\OrderRepo::class);
$container = \think\Container::getInstance();
$same = $container->make(\app\repository\OrderRepo::class);
常见误区
- 以为
app()每次都new:默认按容器绑定规则复用实例,重建需显式传刷新参数。 - 在容器外维护静态全局对象:绕过容器生命周期,难以替换。
追问
- 容器标识默认是什么?答:未单独绑定时使用类名作为标识;绑定后可使用自定义标识。
app()能注册绑定吗?答:可结合bind()或provider.php完成注册,解析用app()。
06.5.2.2-003 bind() 如何绑定类标识?
一句话结论
bind(标识, 类名/闭包/实例) 把容器标识映射到可解析目标;标识唯一,后续 app(标识) 按绑定解析,支持数组批量绑定。
概念解释
绑定只声明“标识对应什么”,不立即创建对象;解析时才实例化。绑定值可以是类名、闭包或已有实例。
原理流程
- 调用
bind('one', \app\model\One::class)登记映射。 - 解析
app('one')时按绑定类名构造对象。 - 批量绑定传入数组一次性登记多个标识。
- 标识大小写保持一致,避免解析不到。
代码或图示
bind('one', \app\model\One::class);
bind([
'user' => \app\model\User::class,
'order' => \app\service\OrderService::class,
]);
$one = app('one');
常见误区
- 绑定标识与解析时大小写不一致:容器按标识严格匹配,解析失败。
- 把闭包绑定写成立即执行的结果:闭包应在解析时被调用,而非绑定前先求值。
追问
- 绑定接口到实现怎么写?答:键为接口名,值为实现类名,注入方类型提示接口。
- 批量绑定文件在哪里维护?答:
app/provider.php返回绑定数组,引导阶段自动登记。
06.5.2.2-004 instance() 绑定已有实例与 bind() 有何区别?
一句话结论
instance(标识, 实例) 直接把一个已经构造好的对象放入容器,解析时返回该固定实例;bind() 绑定的是类名/闭包,解析时才构造。
概念解释
需要在引导阶段手动构造并共享的对象用 instance;需要延迟构造或可替换的用 bind。实例绑定后容器内复用同一对象。
原理流程
- 先
new出对象(可能带手工参数)。 - 调用
instance('key', $object)登记到容器。 - 后续
app('key')返回该实例,不再重新构造。 - 替换时重新绑定新实例覆盖旧映射。
代码或图示
$logger = new \app\log\FileLogger('/var/log/app.log');
instance('file_logger', $logger);
$same = app('file_logger'); // 同一实例
常见误区
- 用
instance绑定每次需要新状态的对象:实例被复用,状态串到后续请求/调用。 - 在请求级对象上用
instance共享:常驻内存场景下需注意状态隔离。
追问
- 单例绑定与实例绑定结果类似吗?答:解析后都复用同一对象;区别在于单例延迟到首次解析创建,实例绑定在绑定时已存在。
- 如何清空容器实例?答:通过容器本体的释放/重置方法,具体方法名以当前版本
Container源码为准(待确认)。
06.5.2.2-005 make() 如何解析实例,参数与重建怎么传?
一句话结论
make(标识, 构造参数, 是否刷新) 从容器解析对象:第二参数传入构造参数,第三参数为 true 时跳过已有实例重新构造;app() 助手是其常用封装。
概念解释
解析时容器反射构造器,按类型提示注入依赖,标量参数由传入参数或请求提供。默认复用已解析实例,刷新参数用于获取新对象。
原理流程
- 传入标识/类名与可选构造参数数组。
- 容器查找绑定,反射构造器并解析类型依赖。
- 非可选标量参数从传入参数或请求数据补齐。
- 第三参数为真时强制重新实例化,不复用缓存实例。
代码或图示
$service = app(\app\service\OrderService::class, ['type' => 'normal']);
$fresh = app('one', [], true); // 每次重新实例化
常见误区
- 以为第三参数控制构造参数:它控制是否重建实例,构造参数是第二参数。
- 给无构造器的类传多余参数:反射时参数不匹配会报错。
追问
- 构造器依赖是接口时怎么解析?答:容器按接口绑定的实现类构造,未绑定则尝试直接实例化接口失败。
- 解析失败报什么错?答:类不存在或依赖无法解析时抛出容器/反射相关异常,具体异常类名以版本源码为准。
06.5.2.2-006 构造器依赖注入如何工作?
一句话结论
控制器或服务在构造方法中声明对象类型参数,容器解析该类时自动构造并注入依赖;无需手动 new,依赖关系显式可见。
概念解释
构造器注入表达对象的必需依赖,便于在类定义处审查。容器递归解析构造器参数,类型为对象的从容器取,标量按规则传入。
原理流程
- 类构造方法参数写类型提示(类/接口)。
- 容器解析该类时反射构造器。
- 逐个解析参数:对象走容器,标量走传入参数或请求绑定。
- 构造完成后注入到新实例并返回。
代码或图示
class Index
{
public function __construct(
private \app\service\UserService $userService
) {}
}
常见误区
- 构造器里写业务初始化副作用:构造应只装配依赖,业务动作放方法。
- 构造器参数堆太多:类职责过大,应拆分服务。
追问
- 构造器注入与方法注入怎么选?答:必需、长期使用的依赖放构造器;单次请求相关或可选依赖可放方法参数。
- 控制器不继承基类也能注入吗?答:可以,构造器注入不依赖控制器基类。
06.5.2.2-007 操作方法(方法)参数如何注入?
一句话结论
控制器操作方法的参数支持依赖注入:对象类型参数由容器解析注入,普通标量参数通过 URL/请求参数绑定传入;方法注入不要求继承基类。
概念解释
方法注入用于单次请求相关的对象(如 Request)。框架调度控制器方法时反射参数列表,对象走容器,标量按路由/请求数据匹配。
原理流程
- 路由调度到控制器方法,反射方法签名。
- 对象类型参数从容器解析(如
Request $request)。 - 标量参数按路由变量、GET/POST 数据绑定。
- 调用方法并传入解析后的参数列表。
代码或图示
public function index(\think\Request $request, int $id)
{
$name = $request->param('name');
return json(['id' => $id, 'name' => $name]);
}
常见误区
- 方法参数类型声明与传入数据不匹配:标量转换失败或类型错误。
- 在方法里再
app()取已可注入的对象:重复定位,依赖不显式。
追问
- 方法参数可以注入自定义服务吗?答:可以,类型提示服务类即可由容器解析。
- 请求对象有哪几种获取方式?答:方法/构造器注入、
Request门面、request()助手,三者指向同一请求实例。
06.5.2.2-008 标量参数与对象参数分别从哪里来?
一句话结论
非可选且非对象的标量参数必须由请求传入(URL 路由变量或请求数据);对象类型参数由容器依赖注入生成,两者在同一方法签名中并存。
概念解释
框架区分参数类型:对象走容器,标量走参数绑定。这解释了为什么控制器方法里既能收 Request 又能收 $id。
原理流程
- 反射方法参数,判断是否有类/接口类型提示。
- 对象参数:容器解析实例。
- 标量参数:按路由变量优先,再合并 GET/POST 数据。
- 缺少必需标量参数时按框架规则报错或给默认值。
代码或图示
// 路由:hello/:name
public function hello(\think\Request $request, string $name)
{
return json(['name' => $name, 'ajax' => $request->isAjax()]);
}
常见误区
- 期望容器给标量参数自动填默认业务值:标量只能来自请求或参数默认值。
- 把配置项当方法标量参数注入:应在构造器/方法内通过
config()读取。
追问
- 路由变量与 GET 同名谁优先?答:
param()合并时路由变量优先,具体合并顺序以 Request 源码为准。 - 可选参数怎么声明?答:参数给默认值,未传入时使用默认值。
06.5.2.2-009 invoke() 如何反射调用 callable 并注入?
一句话结论
容器的 invoke 方法以反射方式调用闭包或类方法,自动解析并注入类型依赖,第二个参数可传入补充参数;常用于通用调度与回调执行。
概念解释
invoke 把“调用可调用结构”与“依赖解析”合并:框架在调度控制器、执行回调时复用同一套参数解析逻辑。
原理流程
- 传入闭包/类方法与补充参数数组。
- 反射可调用结构的签名。
- 对象参数从容器解析,标量从补充参数/请求补齐。
- 反射调用并返回结果。
代码或图示
$result = app()->invoke(function (\app\service\OrderService $service, int $id) {
return $service->detail($id);
}, ['id' => 10]);
常见误区
- 把
invoke当普通call_user_func:它额外做容器注入,参数解析规则不同。 - 闭包参数声明了无法解析的类型:容器抛解析异常。
追问
- 模型方法也支持注入吗?答:模型方法可改造为闭包方式并经
invoke注入,invoke第二参数传补充参数,细节以模型手册为准。 invoke与控制器调度关系?答:控制器调度底层复用反射调用与参数解析机制。
06.5.2.2-010 别名(alias)绑定有什么用?
一句话结论
别名给已有绑定/类名起一个短标识,解析时按别名映射到原绑定;便于在容器中用简洁名称取用同一对象。
概念解释
别名不创建新实例,只是标识层映射。更换实现时改别名背后的绑定,引用别名的代码不变。
原理流程
- 登记别名到原类名/标识的映射。
- 解析别名时容器先查到原标识。
- 按原绑定规则构造/复用实例。
- 别名与原标识解析结果一致。
代码或图示
app()->alias('logger', \app\log\FileLogger::class);
$logger = app('logger');
常见误区
- 以为别名绑定了独立实例:别名只是映射,实例仍归属原绑定。
- 别名与已有标识冲突:解析按容器登记顺序命中,需避免重名。
追问
- 别名方法名在不同版本是否一致?答:以当前版本
Container源码为准(待确认:alias方法签名),可通过bind数组键值形式达到类似效果。 - 门面与别名有关系吗?答:门面
getFacadeClass()返回的类名/标识经容器解析,二者都依赖容器绑定定位。
06.5.2.2-011 如何把接口绑定到实现并注入?
一句话结论
在容器绑定中把接口名映射到实现类名,消费方类型提示接口;解析时容器构造实现并注入,更换实现只改绑定不改调用代码。
概念解释
面向契约编程的核心是依赖抽象。容器负责把抽象连到具体实现,业务层不感知具体类,便于多环境切换与测试替身。
原理流程
- 定义接口(契约)。
- 在
provider.php或服务类中绑定接口到实现。 - 构造器/方法类型提示接口。
- 容器解析接口绑定,注入实现实例。
代码或图示
// provider.php
return [
\app\contract\SmsSender::class => \app\service\AliyunSmsSender::class,
];
public function __construct(private \app\contract\SmsSender $sms) {}
常见误区
- 消费方直接依赖实现类:后续替换需改多处代码。
- 接口未绑定却注入:容器尝试实例化接口直接失败。
追问
- 测试时如何换 mock?答:测试容器中把接口绑定到 mock 实现,再解析被测对象。
- 一个接口多个实现怎么切换?答:用不同标识绑定多个实现,按标识解析;默认实现绑定接口名。
06.5.2.2-012 provider.php 批量绑定怎么组织?
一句话结论
app/provider.php 返回“标识 => 实现类名”数组,框架引导阶段批量登记到容器;这是应用级对象绑定的约定入口。
概念解释
相比代码里散落的 bind(),provider.php 集中可见全部绑定关系。基础对象(自定义 Request、异常处理器)默认在此登记。
原理流程
- 返回关联数组,键为类名/标识,值为实现类名。
- 初始化阶段逐项写入容器绑定表。
- 解析时按标识查找绑定。
- 调整实现只修改数组值。
代码或图示
return [
'app\Request' => \app\Request::class,
'app\ExceptionHandle' => \app\ExceptionHandle::class,
\app\contract\PayGateway::class => \app\service\WxPayGateway::class,
];
常见误区
- 在数组值里写
new表达式:绑定值应为类名/可解析结构,避免引导阶段提前实例化。 - 绑定后又在代码里重复
bind覆盖:两处配置不一致,排查困难。
追问
- 服务类与 provider 如何配合?答:简单映射放
provider.php;需要注册事件、路由或复杂初始化逻辑的继承think\Service。 - 多应用下 provider 作用范围?答:应用级
provider.php对当前应用生效,全局绑定放全局配置/服务,细节以多应用手册为准。
06.5.2.2-013 继承 think\Service 的系统服务做什么?
一句话结论
系统服务在引导阶段向容器注册绑定、事件、路由或扩展;服务类可实现注册与启动两段逻辑,确保组件执行时依赖已就绪。
概念解释
服务是框架的扩展组织方式:包或应用通过服务类把自身能力接入容器与事件系统。注册阶段只做绑定,启动阶段在绑定齐备后执行初始化。
原理流程
- 定义服务类继承
think\Service(非强制)。 - 在服务定义/配置中登记服务类。
- 引导阶段调用注册方法完成绑定。
- 全部注册完成后执行启动方法,做依赖其他绑定的初始化。
代码或图示
namespace app\service;
use think\Service;
class FooService extends Service
{
public function register(): void
{
$this->app->bind('foo', \app\service\Foo::class);
}
public function boot(): void
{
// 依赖已绑定后的初始化
}
}
常见误区
- 在注册阶段调用其他服务注册的服务:此时尚未全部注册完成。
- 服务类里写单次请求处理逻辑:服务只参与引导,不处理请求级状态。
追问
- 服务注册顺序影响什么?答:启动阶段顺序依赖各注册阶段已完成绑定,相互依赖的服务需注意登记次序。
- 第三方包如何接入?答:包内提供服务类并在 Composer 配置中登记,安装后框架自动加载。
06.5.2.2-014 容器内单例如何复用?
一句话结论
容器默认按绑定解析并在容器内复用同一实例(单例语义);需要新对象时显式传刷新参数重建,重建结果按规则再次缓存。
概念解释
单例复用避免重复构造昂贵对象,但要注意实例状态不要在请求间残留。常驻内存模式下复用规则与 FPM 请求模型不同,需单独评估。
原理流程
- 首次解析标识,构造实例并存入容器实例表。
- 后续解析命中实例表,直接返回同一对象。
- 传入刷新参数时跳过实例表重新构造。
- 请求结束后容器随请求销毁(FPM 模型)。
代码或图示
$a = app('one');
$b = app('one'); // 同一实例
$c = app('one', [], true);// 重新实例化
常见误区
- 在单例对象里保存请求级临时状态:后续复用请求时状态串扰。
- 把无状态工具类设计成有状态单例:状态应外置到请求/会话存储。
追问
- 常驻内存下单例生命周期?答:实例跨请求存活,成员变量不会每请求重置,需主动清理或使用请求级对象;Swoole 内部机制不展开。
- 如何确认两个引用是同一实例?答:
===比较对象引用,或在构造方法加日志观察是否只执行一次。
06.5.2.2-015 业务代码里手动 new 有什么问题?
一句话结论
手动 new 绕过容器:依赖无法替换、实例不受容器管理,测试时无法注入替身,也丢失了自动注入能力。
概念解释
容器的价值在于创建方式可插拔。硬编码 new 把实现写死在调用点,类变化需要逐个修改调用处。
原理流程
- 调用点
new XxxService()直接构造。 - 构造器依赖需手工逐层
new补齐。 - 测试/换实现时无法在容器层替换。
- 对象不进入容器实例表,不受生命周期管理。
代码或图示
// 不推荐:依赖写死,无法替换
$service = new \app\service\OrderService(new \app\repository\OrderRepo());
// 推荐:声明类型,容器解析
public function __construct(private \app\service\OrderService $service) {}
常见误区
- 工具类/值对象也强行走容器:无依赖、无状态的简单类直接实例化即可。
- 为了“解耦”把所有类都注册进容器:增加无谓复杂度。
追问
- 哪些对象适合直接
new?答:DTO、值对象、纯函数式工具等无外部依赖的简单类型。 - 遗留代码如何逐步改造?答:先在边界(控制器/服务构造器)注入,再把内部
new上移为构造依赖。
06.5.2.2-016 容器解析失败通常由什么原因导致?
一句话结论
解析失败常见原因:类不存在/命名空间不匹配、接口未绑定实现、构造器标量参数无法从请求补齐、循环依赖;报错为容器或反射相关异常。
概念解释
容器解析依赖反射与自动加载,任何一环缺失都会中断。排查时先确认类文件可被 PSR-4 加载,再检查绑定与参数。
原理流程
- 自动加载定位类文件,找不到则类不存在异常。
- 反射构造器,逐个解析参数。
- 接口/抽象类无绑定则无法实例化。
- 标量参数缺失或循环依赖导致解析中止。
代码或图示
// 排查顺序示例
class_exists(\app\service\OrderService::class); // 自动加载是否命中
app()->bind(\app\contract\SmsSender::class, \app\service\AliyunSmsSender::class);
常见误区
- 命名空间与目录不一致:PSR-4 加载失败,类找不到。
- 看到异常只改报错行:应回溯绑定关系与构造器签名。
追问
- 循环依赖怎么处理?答:调整设计打破环(事件回调、延迟获取、拆分职责),具体容器是否支持循环注入以版本源码为准(待确认)。
- 异常类名怎么核对?答:查看
vendor中容器组件抛出的异常类,8.1.2 起容器为独立依赖。
06.5.2.2-017 app('key', $params, $refresh) 三个参数分别是什么?
一句话结论
第一参数为容器标识/类名,第二参数为构造补充参数数组,第三参数为是否刷新(强制重建);三者控制“取谁、怎么构造、是否复用”。
概念解释
第三参数默认复用容器实例;传 true 时跳过缓存实例重新构造。第二参数在构造需要手工传入标量时使用。
原理流程
- 标识定位绑定目标。
- 补充参数合并到构造器参数解析。
- 刷新标记决定是否读取已有实例。
- 返回解析后的对象。
代码或图示
$a = app('report', ['format' => 'pdf'], true);
$b = app('report', [], false); // 复用容器内实例(默认行为)
常见误区
- 把第二参数当运行方法参数:它只用于构造器补充,不传给业务方法。
- 在常驻内存下频繁刷新单例:实例无法复用,内存与构造开销上升。
追问
- 不传第二参数时构造器标量从哪来?答:从请求参数绑定或参数默认值补齐。
- 第三参数在不同版本签名是否一致?答:以当前版本容器源码为准(待确认),优先用构造器注入替代手工传参。
06.5.2.2-018 容器注入、门面、助手函数三种取用方式如何对比?
一句话结论
构造器/方法注入依赖显式、可测试性最好;门面提供静态语法但隐藏依赖来源;助手函数最简洁但同样弱化显式依赖。推荐核心业务用注入,横切能力可门面/助手。
概念解释
三种方式底层都走容器解析,区别在依赖可见性与测试替换成本。门面静态调用看似无依赖,实际指向容器实例。
原理流程
- 注入:签名声明类型,容器构造并传入,测试可替换 mock。
- 门面:静态魔术方法转发到容器解析实例。
- 助手:函数内部调用容器取实例,语法最短。
- 同一对象三种方式取到的实例一致。
代码或图示
// 注入(推荐)
public function __construct(private \think\facade\Db $db) {}
// 门面静态调用
\think\facade\Db::name('user')->where('id', 1)->find();
// 助手函数
$config = config('app.app_name');
常见误区
- 业务服务里大量用门面:依赖隐藏,单元测试需替换容器绑定才能替身。
- 认为助手函数绕开了容器:它内部仍经容器解析。
追问
- 门面在测试中怎么替换?答:把底层实现/mock 绑定到容器对应标识,门面转发时取到替身。
- 团队规范怎么定?答:控制器/服务层优先构造器注入;日志、配置、缓存等横切调用可使用门面或助手。
06.5.2.2-019 多应用模式下容器绑定的作用域如何理解?
一句话结论
全局绑定对所有应用生效,应用级绑定只在当前应用解析;多应用各自独立容器上下文与配置,跨应用共享的绑定应放在全局层。
概念解释
多应用隔离路由、配置与中间件,容器绑定也分层级。应用专属实现放应用目录,公共契约实现放全局服务/provider。
原理流程
- 引导阶段先装载全局绑定。
- 进入某应用后叠加应用级
provider/配置。 - 解析时按当前应用上下文查找绑定。
- 跨应用复用的对象不应依赖应用专属状态。
代码或图示
全局 config / provider ── 所有应用可见
app/admin/provider.php ── 仅 admin 应用
app/index/provider.php ── 仅 index 应用
// 全局绑定对所有应用生效;应用专属服务在应用 provider 中登记
bind(\app\contract\NotifierInterface::class, \app\service\MailNotifier::class);
$notifier = app(\app\contract\NotifierInterface::class);
常见误区
- 把应用专属服务注册成全局单例:其他应用解析到错误实现或串状态。
- 期望应用级绑定在 CLI 命令中自动生效:命令所属应用上下文需按框架规则确定。
追问
- 多应用容器是否互相隔离实例?答:实例按应用上下文解析,文件缓存等也可按应用区分,细节以多应用手册为准(待确认)。
- 跨应用调用怎么做?答:通过公共服务层或 HTTP/内部接口,不直接跨应用取容器对象。
06.5.2.2-020 测试中如何替换容器绑定以注入替身?
一句话结论
在测试环境把接口/类标识绑定到 mock 或 stub 实现,再解析被测对象;被测类依赖抽象,替身即被注入,无需改动生产代码。
概念解释
可测试性是容器绑定的主要收益之一。替换发生在容器层,生产绑定与测试绑定互不影响。
原理流程
- 定义 mock 实现(继承接口或模拟行为)。
- 测试容器中绑定标识到 mock。
- 解析被测类,构造器收到 mock 实例。
- 断言 mock 被调用的参数与次数。
代码或图示
$mock = new class implements \app\contract\SmsSender {
public function send(string $phone, string $text): bool { return true; }
};
app()->bind(\app\contract\SmsSender::class, $mock);
$service = app(\app\service\OrderService::class);
常见误区
- 被测类直接
new依赖:测试无法通过容器替换替身。 - 测试结束不恢复绑定:同进程后续用例受污染,需在 tearDown 重置容器。
追问
- 门面调用如何在测试中断言?答:替换门面底层绑定的实例,或对容器标识做 mock;门面本身只是转发层。
- 容器实例如何重置?答:使用容器本体提供的刷新/重置方法,具体方法名以版本源码为准(待确认)。