罗罗编程学习记录
本页内容 展开查看

06.5.3.2 DI 容器与服务定位器

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.3 Yii

06.5.3.2-001 Yii::$container 是什么,与服务定位器有什么区别?

一句话结论

Yii::$container 是依赖注入容器(DI Container),负责按定义构造对象并解析其依赖;Yii::$app 是服务定位器(Service Locator),按组件 ID 存取已装配的应用组件,两者职责不同、配合使用。

概念解释

容器解决“如何造对象、依赖从哪来”;定位器解决“按 ID 找到已注册的应用服务”。2.x 中容器可独立于应用解析任意类,定位器则绑定应用级组件实例。

原理流程

  1. 容器维护类名/标识到定义的映射,解析时构造对象并注入依赖。
  2. 定位器维护组件 ID 到组件定义/实例的映射,访问时返回应用级单例。
  3. 应用组件的创建可委托容器完成,定位器缓存最终实例。

代码或图示

// 容器解析任意类
$service = Yii::$container->get(\app\services\PostService::class);
// 定位器取应用组件
$db = Yii::$app->db;

常见误区

  • 把 Yii::$app->db 当成容器:它是定位器取组件,不负责递归解析构造依赖。
  • 认为容器也是全局单例仓库:容器按定义决定单例或新建,定位器里的组件默认复用同一实例。

追问

  • 两者能否互换使用?答:不能;需要递归注入协作者时走容器,需要取应用级横切组件时走定位器。
  • 3.0 中对应物是什么?答:3.0 以 PSR 容器为装配中心,应用级定位器模式基本退出主路径。

06.5.3.2-002 容器定义支持哪三种形式?

一句话结论

服务定义可以是类名字符串、包含 class 的配置数组、返回实例的闭包;容器按形式决定如何创建对象。

概念解释

类名字符串表示直接构造该类;配置数组可指定类、构造参数与属性赋值;闭包工厂接收容器与参数,手工返回对象。定义形式越复杂,可控性越强。

原理流程

  1. 字符串:Container::get 按类名反射构造。
  2. 数组:读取 class,注入构造参数后赋值公共属性。
  3. 闭包:调用闭包并把返回值作为服务实例。

代码或图示

Yii::$container->set('mailer', \app\mail\Mailer::class);
Yii::$container->set('report', [
    'class' => \app\services\ReportService::class,
    'pageSize' => 20,
]);
Yii::$container->set('clock', fn() => new \app\helpers\SystemClock());

常见误区

  • 配置数组忘记写 class:容器无法确定实例化哪个类。
  • 在闭包内做重初始化:工厂只负责返回实例,不应在每次解析时执行副作用。

追问

  • 数组定义里非构造属性如何赋值?答:匹配类的公共属性或 setter,按配置键赋值;不存在的属性行为以框架版本为准,需核对实现。
  • 闭包能否接收构造参数?答:工厂闭包可通过容器与解析参数取得上下文,具体签名以容器版本接口为准。

06.5.3.2-003 set / setSingleton / setDefinitions 如何使用?

一句话结论

set() 登记普通定义,setSingleton() 登记每次解析复用同一实例的定义,setDefinitions() 批量登记多个定义;三者都写入容器定义表,解析时按标记决定实例生命周期。

概念解释

普通定义每次 get 可新建实例;单例定义首次创建后缓存,后续返回同一对象。批量方法一次导入配置数组,减少逐条调用。

原理流程

  1. set($class, $definition, $params) 登记定义与构造参数。
  2. setSingleton($class, $definition) 标记单例。
  3. setDefinitions($definitions) 遍历数组批量注册。

代码或图示

Yii::$container->setSingleton('logger', \app\log\AppLogger::class);
Yii::$container->setDefinitions([
    'auditor' => ['class' => \app\audit\AuditService::class],
    'notifier' => \app\notify\Notifier::class,
]);

常见误区

  • 把有状态服务注册成单例:请求内累积的状态会跨解析残留,单例应无状态或显式设计复用。
  • 以为 set 立即实例化对象:登记定义不等于创建实例,首次 get 才构造。

追问

  • 单例能否手动重置?答:取决于容器实现是否提供清除/重新解析接口;2.x 与 3.0 能力不同,版本行为需对照官方文档确认。
  • 批量定义中能否混闭包?答:可以,每个值按三种定义形式分别解析。

06.5.3.2-004 get() 如何按构造器类型提示自动解析依赖?

一句话结论

容器反射目标类构造函数,对声明了类/接口类型提示的参数递归从容器解析;标量与无类型参数按定义提供,无法满足时抛出依赖解析异常。

概念解释

自动解析只针对类型提示明确的对象参数;构造函数需要的标量配置不猜测,必须通过定义参数或配置数组提供。解析过程递归进行,协作者的依赖同样由容器构造。

原理流程

  1. get 读取目标类定义与参数。
  2. 反射构造函数,逐个识别参数类型。
  3. 对象类型参数从容器解析(递归),标量参数取定义值。
  4. 组装参数实例化,按定义处理单例缓存。

代码或图示

class PostService
{
    public function __construct(
        private \app\repositories\PostRepositoryInterface $repo
    ) {}
}
// 容器自动注入已绑定的仓库实现
$service = Yii::$container->get(PostService::class);

常见误区

  • 构造函数参数不写类型:容器无法推断应注入什么对象,只能靠显式参数。
  • 接口未绑定实现:解析到接口类型时找不到具体类,会抛解析异常。

追问

  • 可选参数(nullable)如何处理?答:未提供解析值时按 null 处理或走容器默认行为,具体以反射解析实现为准。
  • 构造函数过多如何改善?答:拆分职责或引入参数对象,避免构造签名膨胀。

06.5.3.2-005 构造注入、方法注入与属性赋值在 Yii 2.x 中的位置

一句话结论

Yii 2.x 以构造注入为主路径;容器定义数组支持公共属性赋值,方法注入能力有限,业务类应优先通过构造函数声明依赖。

概念解释

构造注入保证对象创建后依赖可用,便于不可变设计;属性赋值在实例化后按配置填充;方法注入通常出现在框架特定回调(如控制器动作参数绑定)中,不是通用容器特性。

原理流程

  1. 构造函数声明对象依赖,容器解析传入。
  2. 实例化后配置数组遍历赋值属性。
  3. 框架回调场景再做方法参数绑定。

代码或图示

class OrderService
{
    public function __construct(
        private \app\pay\PaymentGateway $gateway,
        private int $notifyLimit = 3
    ) {}
}

常见误区

  • 把依赖写成可写公共属性再让容器填充:破坏封装,测试时容易漏赋值。
  • 依赖在方法体内 new:绕过容器,无法替换与测试。

追问

  • 属性赋值与构造参数冲突时以谁为准?答:构造先执行,随后属性赋值覆盖;设计上应避免同一依赖两处声明。
  • 3.0 对注入方式的态度?答:官方推荐构造注入,方法注入用于框架回调场景,属性注入不是主流装配方式。

06.5.3.2-006 单例与新建实例的生命周期有何区别?

一句话结论

单例定义在容器生命周期内复用同一实例;普通定义每次解析按定义新建对象;应用组件默认作为定位器级别的复用实例存在。

概念解释

容器单例解决协作者共享同一状态(如连接、配置读取器);新建实例适合无状态或每次需要独立状态的对象。PHP 请求结束后容器与实例随进程销毁,不跨请求保留状态。

原理流程

  1. 首次解析:构造对象,单例写入缓存,普通定义不缓存。
  2. 再次解析:单例返回缓存实例,普通定义重新构造。
  3. 请求结束:容器释放,实例随内存回收。

代码或图示

Yii::$container->setSingleton('db-proxy', \app\db\ProxyConnection::class);
$a = Yii::$container->get('db-proxy');
$b = Yii::$container->get('db-proxy');
var_dump($a === $b); // bool(true)

常见误区

  • 在单例里保存请求级状态(如当前用户):后续解析复用会串状态。
  • 把跨请求缓存当单例用途:跨请求数据必须进 cache/db/session,内存单例不持久。

追问

  • 数据库连接为什么适合单例?答:连接复用避免重复握手,且连接对象本身无请求级可变状态。
  • 单例能否在运行时换实现?答:需重新绑定定义或清空缓存;运行时替换要评估已持有旧实例的协作者。

06.5.3.2-007 懒加载如何避免启动期创建全部服务?

一句话结论

容器与定位器只登记定义,服务在首次被访问时才实例化;未使用的服务不占用构造开销,引导阶段只做配置解析与绑定。

概念解释

components 配置中的对象默认懒加载;只有 bootstrap 列表中的组件会在引导阶段强制创建。容器同理,set 不等于 get,定义存表不构造。

原理流程

  1. 引导阶段:注册定义、别名、事件,不实例化业务服务。
  2. 请求阶段:首次访问某服务触发解析。
  3. 解析完成后实例在应用/容器作用域内复用。

代码或图示

// 配置只登记定义,连接尚未建立
Yii::$app->set('report-db', [
    'class' => yii\db\Connection::class,
    'dsn' => 'mysql:host=127.0.0.1;dbname=report',
]);
// 首次访问时才真正建立连接
Yii::$app->get('report-db')->open();

常见误区

  • 在引导日志里统计“服务数量”以为都已初始化:定义数不等于实例数。
  • 把重依赖服务放进 bootstrap:失去懒加载收益,拖慢每个请求。

追问

  • 懒加载失败何时暴露?答:首次访问时才抛依赖/连接异常,启动期不易发现;关键服务可在引导后做一次健康检查。
  • 3.0 是否同样懒加载?答:容器按解析时点构造,服务未取到时不实例化;模板装配阶段注册的是定义而非实例。

06.5.3.2-008 Yii::$app 服务定位器:getComponent/hasComponent/setComponent

一句话结论

应用继承服务定位器,getComponent($id) 取组件(不存在返回 null 或按配置创建),hasComponent($id) 判断是否登记,setComponent($id, $component) 登记或替换实例。

概念解释

定位器把组件 ID 映射到定义或实例;魔术属性 Yii::$app->db 内部走 getComponent('db')。组件定义与实例都可被写入,便于测试替换。

原理流程

  1. 配置阶段应用读取 components 定义。
  2. hasComponent 检查定义或实例表。
  3. getComponent 按需创建并缓存实例。
  4. setComponent 直接放入现成实例,覆盖原有定义。

代码或图示

if (Yii::$app->hasComponent('cache')) {
    Yii::$app->getComponent('cache')->set('k', 'v');
}
Yii::$app->setComponent('audit', new \app\audit\AuditService());

常见误区

  • 直接给 Yii::$app->xxx = 对象 而不理解定位器语义:临时替换影响后续所有持有该 ID 的代码。
  • 用定位器绕过接口抽象:组件 ID 字符串耦合在业务代码中,不利于测试替换。

追问

  • 组件定义与现成实例同时存在时谁优先?答:已 setComponent 的实例优先;具体查找顺序以定位器实现为准。
  • 定位器能否嵌套模块组件?答:模块自身也是定位器,应用组件与模块组件按上下文分别存取。

06.5.3.2-009 配置数组中 class、构造参数与属性如何书写?

一句话结论

数组定义以 class 指定实现类,可用 __construct 形式声明构造参数(版本支持以框架文档为准),其余键按公共属性或 setter 赋值。

概念解释

配置数组是框架对象装配的主要写法:类名、构造实参、属性值分层书写;构造参数与属性键不要混淆,标量配置与对象引用在同一数组中混合表达。

原理流程

  1. 读取 class 得到实现类。
  2. 组装构造参数(显式参数或类型提示解析)。
  3. 实例化后遍历剩余配置键赋值属性。

代码或图示

[
    'class' => \app\mail\Mailer::class,
    'transport' => \app\mail\SmtpTransport::class,
    'timeout' => 10,
]

常见误区

  • 把构造必填参数写成属性键:构造阶段拿不到该参数,实例化报错。
  • 属性名拼错:配置静默忽略或报未知属性,取决于版本严格程度,应在测试中覆盖。

追问

  • 数组中嵌套另一个组件定义如何解析?答:嵌套数组同样按定义解析为对象后传入;容器会递归处理。
  • 构造参数列表与属性赋值顺序?答:先构造后赋值;需要依赖构造结果的配置不能放在构造前。

06.5.3.2-010 接口到实现如何绑定?

一句话结论

把接口(或抽象类)作为容器键,值绑定到具体实现类或工厂;消费方依赖接口,解析时容器返回绑定的实现,替换实现只需改绑定配置。

概念解释

接口绑定是解耦与可测试性的核心:业务代码面向接口,基础设施实现可替换。测试时把接口绑定到 Mock 实现即可,无需改动业务类。

原理流程

  1. 定义仓库/网关等接口。
  2. 配置阶段把接口绑定到生产实现。
  3. 服务构造函数类型提示接口,容器解析时取绑定实现。

代码或图示

Yii::$container->set(
    \app\repositories\PostRepositoryInterface::class,
    \app\repositories\DbPostRepository::class
);

常见误区

  • 消费方仍然类型提示具体类:绑定接口的收益被抵消,替换实现时仍要改代码。
  • 接口多个实现共用一键:同一容器键只能有一个当前绑定,多实现应分别命名或用工厂选择。

追问

  • 按上下文选择不同实现怎么做?答:用工厂闭包根据环境/配置返回实现,或定义多个命名服务再由装配方选择。
  • 3.0 配置中接口绑定写法?答:配置数组以接口 ::class 为键、实现为值,与 2.x 思路一致,格式细节以 yiisoft/di 文档为准。

06.5.3.2-011 测试中如何用容器覆盖依赖?

一句话结论

测试前把接口/服务键重新绑定到 Stub 或 Mock 实现,再解析被测对象;通过容器替换协作者,避免连真实数据库、外部网关。

概念解释

可替换性是依赖注入相对服务定位器的主要优势:测试装配独立于生产配置,构造出隔离的被测图。断言落在交互与输入输出上,不依赖外部系统状态。

原理流程

  1. 测试容器(或应用容器)登记 Mock 绑定。
  2. 解析被测服务,容器注入 Mock 协作者。
  3. 调用被测方法,对 Mock 行为与返回值做断言。

代码或图示

Yii::$container->set(
    NotifyGatewayInterface::class,
    FakeNotifyGateway::class
);
$service = Yii::$container->get(PostService::class);

常见误区

  • 测试里直接 new Service(new RealDb()):绕开容器替换,集成测试才需要真实依赖。
  • 重新绑定后未隔离用例:Mock 残留影响后续测试,每个用例应重建或重置容器状态。

追问

  • 2.x 应用组件如何在测试替换?答:Yii::$app->setComponent 可放入 Mock 组件实例,测试结束恢复原实例。
  • 静态门面式调用如何解耦?答:把静态调用收敛到接口实现内,业务依赖接口才能被替换。

06.5.3.2-012 构造标量参数与容器参数列表如何提供?

一句话结论

标量配置不能由容器自动推断,需在定义的参数列表或配置数组中显式提供;对象参数按类型提示解析,标量参数按位置/名称匹配定义值。

概念解释

容器反射构造函数时,对象类型走自动解析,int/string/bool 等标量取定义中的参数值;缺省参数可给默认值,必填标量未提供则解析失败。

原理流程

  1. 读取定义附带的参数表。
  2. 遍历构造参数:对象解析容器,标量取参数表值,可选参数用默认值。
  3. 组装后实例化。

代码或图示

Yii::$container->set('searcher', [
    'class' => \app\search\SearchService::class,
    '__construct()' => [10],
]);

常见误区

  • 期望容器从应用 params 自动注入标量:params 需显式传入定义,容器不自动关联全局参数。
  • 参数顺序与构造签名错位:位置绑定容易出错,优先用命名配置/参数对象。

追问

  • 全局参数(params)如何进入服务?答:在配置定义中引用 Yii::$app->params['...'] 或环境值,显式传入。
  • 标量配置过多怎么办?答:收敛为配置值对象,构造函数接收单一配置对象。

06.5.3.2-013 循环依赖如何暴露与规避?

一句话结论

A 构造依赖 B、B 构造又依赖 A 时,容器递归解析进入死循环并抛出异常;规避方式是打破构造环,改为方法调用时获取、事件回调或引入中介服务。

概念解释

构造注入要求对象创建即就绪,循环构造无法满足。常见解法:把其中一方协作者改为延迟获取(定位器/工厂),或抽取共享第三方由双方依赖。

原理流程

  1. 解析 A → 构造参数需要 B。
  2. 解析 B → 构造参数又需要 A。
  3. 递归无法终止,容器检测到循环并报错(具体异常类型以版本为准)。

代码或图示

// 反例:构造环
class OrderService { public function __construct(Payment $p) {} }
class Payment { public function __construct(OrderService $o) {} }
// 改法:Payment 在方法内通过工厂/定位器按需取 OrderService

常见误区

  • 用单例“解决”循环依赖:单例只缓存实例,首次构造时环仍然存在。
  • 把环藏进属性赋值:构造环转为属性环,运行时仍可能拿到未就绪对象。

追问

  • 循环依赖一定是设计问题吗?答:多数情况反映职责边界耦合,应先拆分职责而非寻找容器技巧。
  • 容器是否检测循环深度?答:多数 DI 容器会在递归超限时报错;具体检测机制与异常信息以实现文档为准。

06.5.3.2-014 容器、服务定位器与模块引导的关系?

一句话结论

应用引导时把组件定义登记到定位器,必要时委托容器构造;模块在 init() 中可登记自身组件与事件;三者在应用对象树上分层装配。

概念解释

应用级组件通过 Yii::$app 定位;模块级服务在模块上下文注册;底层通用对象交给容器解析。模块初始化早于其控制器执行,可在此补充绑定。

原理流程

  1. 应用构造:注册 components 定义到定位器。
  2. 模块 init():追加模块组件、行为与事件订阅。
  3. 控制器解析时:应用/模块定位器取组件,容器解析协作者。

代码或图示

class Module extends yii\base\Module
{
    public function init()
    {
        parent::init();
        Yii::$container->set(ModuleService::class, ModuleService::class);
    }
}

常见误区

  • 在模块 init 中覆盖应用全局组件:应新增模块自己的组件 ID,避免污染全局。
  • 模块服务通过 Yii::$app 取内部协作者:模块内聚服务应走模块上下文或容器绑定。

追问

  • 模块能否注册容器单例?答:可以通过容器 set/setSingleton 登记;作用域跟随容器生命周期。
  • 引导顺序影响什么?答:先注册的定义可被后续初始化引用,事件订阅时机决定能否收到早期事件。

06.5.3.2-015 依赖解析的递归过程是怎样的?

一句话结论

解析一个服务时,容器沿构造依赖逐层向下解析,叶子对象先构造,再自底向上组装参数,最终得到目标对象;单例在各层按需缓存。

概念解释

递归解析保证每个协作者就绪后才构造上层对象;解析过程可混合自动类型提示与显式定义参数。任一层缺少可解析依赖都会中断并抛出异常。

原理流程

  1. 取目标服务定义。
  2. 遍历构造参数,对象类型进入子解析。
  3. 子服务递归完成后返回实例。
  4. 自底向上组装,返回目标服务。

代码或图示

PostService
  └─ PostRepository (接口 → DbPostRepository)
       └─ Connection (应用 db 组件)

常见误区

  • 以为解析是一次性 new:嵌套对象同样经过容器,替换绑定对子层生效。
  • 子层有副作用初始化却依赖父层状态:构造期拿不到父层状态,应改为方法调用时传入。

追问

  • 解析深度过大说明什么?答:对象图过深通常是职责未分层,应通过服务拆分与接口收敛。
  • 递归解析性能如何?答:反射解析有开销,框架可缓存定义元数据;生产环境配合 OPcache 降低成本。

06.5.3.2-016 定义中嵌套对象如何被解析?

一句话结论

配置数组内嵌套数组或类名会被容器作为子定义解析为对象;嵌套层级不限,容器递归处理直至叶子标量或现成实例。

概念解释

嵌套定义表达“服务的某个协作者如何构造”;嵌套数组同样支持 class、属性与参数。直接传入的现成实例保持原样,不再二次构造。

原理流程

  1. 读取外层定义。
  2. 遇到嵌套数组/类名:作为子定义交给容器解析。
  3. 子对象返回后作为外层构造参数或属性值。
  4. 现成实例直接沿用。

代码或图示

[
    'class' => \app\order\OrderService::class,
    'notifier' => [
        'class' => \app\notify\MailNotifier::class,
        'channel' => 'order',
    ],
]

常见误区

  • 嵌套定义写错层级:被当成普通数组传入,类型不符在运行期报错。
  • 嵌套复用同一段配置却多处复制:应抽为独立命名服务再引用,保持配置一致。

追问

  • 嵌套对象能否引用外层服务?答:构造期外层尚未就绪,不能反向引用;需要互访时走方法参数或延迟获取。
  • 嵌套定义是否也分单例?答:默认按子定义自身标记;未标单例的嵌套对象每次外层解析时重建。

06.5.3.2-017 Yii 3.0 容器:PSR Container 与配置格式有何不同?

一句话结论

3.0 容器遵循 PSR-Container 接口思路,配置以数组返回绑定(接口到实现、构造参数、setter 调用、工厂闭包),装配显式可调试,不再依赖 Yii::$container 静态门面。

概念解释

3.0 配置示例包含接口映射、带 __construct() 与 setter 调用的详细定义、闭包工厂;构造函数按类型提示自动注入。容器可被其他 PSR 兼容容器替换。

原理流程

  1. 配置文件返回绑定数组。
  2. 容器构建时导入定义。
  3. 处理器/服务解析时自动注入类型提示依赖。

代码或图示

return [
    EngineInterface::class => EngineMarkOne::class,
    'api' => static fn(ApiConfig $config) => new ApiClient($config),
];

常见误区

  • 把 2.x 的 Yii::$container->set() API 直接搬到 3.0:包接口与配置形式已变化,需对照 yiisoft/di 文档。
  • 继续使用应用定位器取服务:3.0 主路径是构造注入。

追问

  • 3.0 容器是否支持方法调用配置?答:配置可表达 setter 调用(如 setDiscount() 形式),具体键名与签名以容器包文档为准。
  • 能否混用第三方 PSR 容器?答:可以按接口替换,前提是现有代码不依赖 Yii 容器专有 API。

06.5.3.2-018 工厂闭包如何作为服务定义?

一句话结论

工厂闭包接收容器(及解析参数),内部决定如何构造对象并返回实例;适合需要条件选择、外部资源初始化或复合组装的服务。

概念解释

当类构造无法纯配置表达(读取环境、组合多个协作者、按配置选实现)时,用闭包工厂把装配逻辑集中在定义处;返回的实例按容器单例/普通规则处理。

原理流程

  1. 定义值为闭包。
  2. 解析时容器调用闭包,传入容器上下文。
  3. 闭包内构造并返回对象。
  4. 对象进入容器生命周期管理。

代码或图示

Yii::$container->set('storage', function ($container) {
    $driver = Yii::$app->params['storage.driver'] ?? 'file';
    return $driver === 'redis'
        ? $container->get(RedisStorage::class)
        : $container->get(FileStorage::class);
});

常见误区

  • 闭包内读取请求级状态:工厂在解析期执行,请求上下文需确保已就绪,关键状态应延迟到方法内获取。
  • 闭包内缓存自己的实例:应交给容器单例管理,避免双重缓存。

追问

  • 工厂闭包能否接收额外参数?答:取决于容器 get 传参与闭包签名,版本能力需对照文档确认。
  • 闭包与配置数组如何选择?答:能声明式表达用数组,需要分支逻辑或手工组装再用闭包。

06.5.3.2-019 服务定位器滥用的边界在哪里?

一句话结论

定位器适合应用级横切组件访问;业务服务内部应通过构造注入获取协作者,把 Yii::$app 散落进领域对象会造成隐式依赖、难以测试与替换。

概念解释

服务定位器让对象隐藏自己需要的依赖,接口上看不出协作者;依赖注入则在构造签名中显式声明。边界原则:控制器/入口可使用定位器,领域服务与仓储应面向接口注入。

原理流程

  1. 入口层:从定位器取组件开始组装对象图。
  2. 业务层:构造函数显式接收协作者。
  3. 测试层:替换接口绑定验证业务逻辑。

代码或图示

// 不推荐:领域对象内部到处取定位器
class OrderService {
    public function pay() {
        $mailer = Yii::$app->mailer; // 隐式依赖
    }
}
// 推荐:构造注入
class OrderService {
    public function __construct(private MailerInterface $mailer) {}
}

常见误区

  • 把定位器当便利工具在任意类静态调用:依赖被隐藏,单元测试必须先装配整个应用。
  • 认为用了 Yii::$app 就不是 DI:定位器是反模式边缘,不能替代显式注入。

追问

  • 2.x 遗留代码如何逐步改造?答:先把定位器调用收敛到接口实现,再把接口通过构造注入传入服务。
  • 哪些场景定位器仍合理?答:框架基类(控制器、模块)访问日志、数据库等应用级横切组件。

06.5.3.2-020 常见容器误区:绕过容器 new、全局静态与配置泄漏

一句话结论

绕过容器直接 new 会使依赖无法替换;全局静态持有可变状态难以测试;配置中写死环境值会造成环境耦合,三者都应在评审中识别并纠正。

概念解释

容器收益来自统一装配与替换;手工 new 切断这条链路。静态类只适合无状态工具函数,不应持有服务实例。配置应分层,环境相关值走本地/环境配置。

原理流程

  1. 评审对象创建点:是否经过容器或显式工厂。
  2. 检查静态调用:是否隐藏了可替换协作者。
  3. 检查配置:凭据、主机、开关是否与公共配置分离。

代码或图示

// 反例:绕过容器
$service = new PostService(new DbPostRepository());
// 正例:依赖由容器解析
$service = Yii::$container->get(PostService::class);

常见误区

  • 认为“new 一个简单类没关系”:即使当前简单,后续加依赖就会变成手工装配点。
  • 在框架配置里写死生产密钥:应进本地配置或环境变量,文档示例只给占位。

追问

  • 工具类(无状态辅助函数)能否静态?答:可以,纯函数式工具不持有服务依赖时静态调用没有测试问题。
  • 遗留代码改造优先级?答:先改被测试覆盖少、依赖外部系统的服务,再清理控制器内的定位器散落点。