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

06.5.5.2 DI 容器与依赖注入

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

06.5.5.2-001 Hyperf 的 DI 容器承担什么角色?如何拿到容器实例?

一句话结论

容器负责对象创建、依赖解析与实例缓存,是 Hyperf 组装对象图的中心;业务代码通常通过 ApplicationContext::getContainer() 获取容器,再按类名或标识解析对象。

概念解释

容器把“类怎么造、依赖从哪来”从业务代码中剥离:控制器只声明需要的服务,容器在解析时递归注入依赖。容器还承担接口到实现的绑定、单例缓存与测试替换。

原理流程

  1. 启动期框架构建容器实例并注册配置绑定。
  2. 业务需要对象时调用 get($id),容器查找已有实例或解析新实例。
  3. 解析过程中递归构造函数与属性注入,形成完整对象图。
  4. 实例按容器策略缓存复用。

代码或图示

use Hyperf\Context\ApplicationContext;
use App\Service\UserService;

$container = ApplicationContext::getContainer();
$userService = $container->get(UserService::class);

常见误区

  • 在业务代码里到处 new 依赖:绕过容器后属性注入、接口绑定与 AOP 代理都不生效。
  • 把容器当服务定位器在每层随意取用:优先构造函数注入,容器只在工厂、命令入口等边界使用。

追问

  • ApplicationContext 命名空间在 2.x 与 3.x 有差异吗?答:2.x 为 Hyperf\Utils\ApplicationContext,3.x 调整到 Hyperf\Context\ApplicationContext;以当前版本自动加载结果为准(待确认)。
  • 容器自身什么时候创建?答:在入口引导阶段创建,先于 Server 启动;请求阶段复用同一容器实例。

06.5.5.2-002 容器的 get、set、has 分别怎么用?

一句话结论

get($id) 解析并返回对象,set($id, $definition) 注册绑定或实例,has($id) 判断标识是否已绑定;三者是容器最基础的读写查询 API。

概念解释

$id 通常是类名或接口名;set 可绑定实现类、闭包或已有实例。has 只判断绑定是否存在,不等于实例已经创建。解析失败时容器抛出依赖解析异常。

原理流程

  1. has($id) 先查绑定表,命中返回 true。
  2. get($id) 命中缓存直接返回,否则按定义解析。
  3. set($id, $definition) 写入绑定表,覆盖已有绑定。
  4. 解析完成后按策略缓存实例。

代码或图示

$container = ApplicationContext::getContainer();

if ($container->has(UserServiceInterface::class)) {
    $service = $container->get(UserServiceInterface::class);
}

$container->set(SomeCache::class, new SomeCache());

常见误区

  • 以为 has 为 false 时容器一定无法创建:未显式绑定的具体类仍可通过反射自动解析。
  • 在请求期频繁 set 替换单例:会污染常驻容器,影响后续协程;测试替换应在隔离环境进行。

追问

  • make 与 get 有什么区别?答:部分容器实现提供 make 用于按参数临时解析;Hyperf 中对应方法名与行为以当前版本源码为准(待确认:核对 Hyperf\Di\Container 公开方法)。
  • 绑定标识可以是字符串吗?答:可以用字符串别名,但项目内推荐类名/接口名作为标识,便于静态分析与重构。

06.5.5.2-003 构造函数注入是如何自动解析的?

一句话结论

容器反射读取构造函数参数类型,递归从容器解析每个依赖并传入;类型明确的类可自动装配,无需手写工厂,这是 Hyperf 最常用的注入方式。

概念解释

构造函数注入把必填依赖显式写进签名,便于阅读与测试。容器解析时先处理参数类型:类类型递归 get,标量与可选参数按默认值或绑定定义处理。

原理流程

  1. 容器反射目标类构造函数,获取参数列表。
  2. 对每个类类型参数递归解析依赖实例。
  3. 可选参数使用默认值,无法解析的标量参数需要绑定定义。
  4. 调用构造函数生成对象并完成后续属性注入。

代码或图示

class OrderController
{
    public function __construct(
        private OrderService $orderService,
        private PaymentService $paymentService
    ) {
    }
}

常见误区

  • 构造函数参数写标量类型又不给默认值:容器无法凭空提供业务标量,需通过工厂闭包或配置绑定传入。
  • 在构造函数里做重 IO:构造发生在依赖解析期,重操作应延迟到方法调用或启动监听器。

追问

  • 构造函数注入与属性注入哪个优先?答:必填、不可变依赖优先构造函数注入;可选或可选替换的依赖可用属性注入。
  • 循环构造依赖会怎样?答:互相构造注入形成闭环时容器无法完成解析,会抛出循环依赖相关异常(具体异常类型待确认)。

06.5.5.2-004 #[Inject] 属性注入如何按类型推断?

一句话结论

在属性上标注 #[Inject],容器依据 @var 注解或 PHP 类型声明确定注入类型,解析对应对象并赋值;属性注入适合补充可选依赖与框架组件。

概念解释

Inject 注解命名空间为 Hyperf\Di\Annotation\Inject。注入类型来自属性的 PHP 类型或 @var PHPDoc;被注入对象必须由容器创建,new 出来的对象不会自动完成注解注入。

原理流程

  1. 扫描期识别属性上的 #[Inject],记录属性与类型。
  2. 对象由容器解析时,按类型从容器获取依赖。
  3. 依赖实例赋值到目标属性。
  4. 完成注入后对象才返回给使用方。

代码或图示

use Hyperf\Di\Annotation\Inject;
use App\Service\UserService;

class IndexController
{
    #[Inject]
    private UserService $userService;

    #[Inject]
    /** @var UserService */
    private $legacyService;
}

常见误区

  • 给 new IndexController() 的对象期待自动注入:只有容器创建的对象才走注解注入流程。
  • 属性类型与 @var 不一致:容器按声明类型解析,类型错配会导致注入错误对象或解析失败。

追问

  • 注入接口类型可以吗?答:可以,前提是 dependencies.php 已把接口绑定到具体实现类。
  • 属性可见性影响注入吗?答:私有属性同样可由容器反射注入;可见性不阻止框架注入,但建议按封装需要选择。

06.5.5.2-005 #[Inject] 的 required 参数起什么作用?

一句话结论

required 默认 true,依赖无法解析时抛出异常;设为 false 表示可选依赖,解析失败时注入 null 而不中断流程。

概念解释

可选依赖用于“有则用、无则降级”的场景,例如增强型组件、可选缓存驱动。显式标注 required=false 比让异常被上层兜底更可控。

原理流程

  1. 容器解析 #[Inject(required: false)] 属性。
  2. 依赖不存在或不可创建时,按可选处理。
  3. 属性赋值为 null,业务代码先判空再使用。
  4. required=true(默认)时解析失败直接抛出异常。

代码或图示

use Hyperf\Di\Annotation\Inject;

class ReportController
{
    #[Inject(required: false)]
    private ?MetricsReporter $reporter = null;

    public function export(): void
    {
        $this->reporter?->count('export');
    }
}

常见误区

  • 把必填依赖也标成 required=false:问题被延迟到运行期空指针暴露,不如启动/解析阶段失败明确。
  • 判空遗漏:可选依赖为 null 时直接调用方法会触发错误。

追问

  • required=false 注入 null 后类型声明怎么写?答:属性声明为可空类型(如 ?Reporter),与注入结果保持一致。
  • 可选依赖默认值能给对象吗?答:属性可给默认值,但容器注入时会覆盖;默认值只在未注入场景兜底。

06.5.5.2-006 lazy 懒加载注入解决什么问题?

一句话结论

#[Inject(lazy: true)] 注入一个懒加载代理,依赖在首次方法调用时才真正解析,用于打破启动期循环依赖或延迟重依赖的初始化成本。

概念解释

代理对象实现与目标相同的调用入口,内部持有容器与延迟解析逻辑;首次调用方法时解析真实对象并转发。懒加载不改变依赖关系,只推迟实例化时机。

原理流程

  1. 标注 lazy=true 后容器为属性生成代理对象。
  2. 代理在首次方法调用触发真实依赖解析。
  3. 解析得到实例后转发调用并缓存。
  4. 后续调用直接走真实对象。

代码或图示

use Hyperf\Di\Annotation\Inject;

class OrderService
{
    #[Inject(lazy: true)]
    private HeavyReportService $reportService;
}

常见误区

  • 用懒加载掩盖循环依赖设计:循环依赖仍应通过拆分职责、事件回调等方式根治。
  • 以为懒加载代理类型与原类完全一致可反射:代理是框架生成的包装类型,反射获取属性时需留意代理结构。

追问

  • 懒加载代理在测试中如何替换?答:测试绑定真实 mock 实现;若注入点走代理,需在容器配置中确认代理生成规则(待确认:核对当前版本懒加载代理实现)。
  • 哪些场景适合懒加载?答:启动期不需要、调用频次低或构造较重的依赖;高频核心路径不必懒加载。

06.5.5.2-007 接口与实现如何在 dependencies.php 中绑定?

一句话结论

在 config/autoload/dependencies.php 返回数组,以接口(或抽象类)为键、实现类为值;容器解析接口时自动绑定到配置的实现,面向抽象编程可替换。

概念解释

绑定把“依赖什么抽象”与“用什么具体类”解耦:控制器依赖接口,切换实现只改配置。这也是单元测试中替换 mock 的配置入口之一。

原理流程

  1. 编写接口约定方法签名。
  2. 在 dependencies.php 登记 接口::class => 实现::class。
  3. 容器解析接口时查表,实例化绑定实现。
  4. 需要切换实现时修改绑定,业务代码不变。

代码或图示

// config/autoload/dependencies.php
return [
    \App\Contract\UserRepositoryInterface::class => \App\Repository\MysqlUserRepository::class,
    \App\Contract\CacheInterface::class => \App\Cache\RedisCache::class,
];

常见误区

  • 业务直接依赖具体实现类再谈解耦:不经过接口,配置替换无法生效。
  • 接口与实现命名空间混乱:契约放在 Contract 目录,实现放在 Repository/Service 目录,职责清晰。

追问

  • 绑定闭包工厂怎么做?答:值可为闭包,接收容器并返回对象;适合需要传参或组合多个依赖的复杂构造(具体闭包签名待确认)。
  • 同一接口能绑定多个实现吗?答:按单绑定标识解析默认实现;多实现可用不同标识字符串分别注册,再按标识获取。

06.5.5.2-008 容器中的单例与原型如何区分?

一句话结论

Hyperf 容器默认把解析出的对象作为单例在容器内复用;需要每次返回新实例时,通过闭包工厂返回新对象或在解析时传入参数,原型行为以当前版本容器实现为准。

概念解释

单例适合无状态服务、客户端、连接池持有器;原型适合携带可变状态的对象。常驻进程中误用原型存放请求状态会失去复用意义,误用单例存可变状态则会串数据。

原理流程

  1. 首次 get 解析对象并缓存到容器实例表。
  2. 后续 get 同一标识直接返回缓存实例。
  3. 闭包工厂每次调用可返回新对象,实现按需新建。
  4. 含状态对象用完即弃,不写入容器长期缓存。

代码或图示

// 闭包工厂每次返回新的状态对象(工厂签名以版本实现为准,待确认)
$container->set(Calculator::class, function () {
    return new Calculator();
});

常见误区

  • 以为容器内每个对象都是原型:默认缓存复用,单例行为是常态。
  • 在单例服务里保存可变成员状态:跨协程共享后会互相覆盖。

追问

  • 连接池对象为什么适合单例?答:池本身需要长期持有连接集合,单例复用避免重复建池;池内连接由协程借用归还。
  • 如何确认某对象是单例?答:在两次 get 后用 === 比较引用是否相同;或阅读容器解析与缓存源码确认策略。

06.5.5.2-009 依赖解析的优先级是怎样的?

一句话结论

解析顺序通常为:显式绑定(配置/容器 set)优先,其次按类反射自动解析;接口无绑定时无法自动猜测实现,具体类则可反射构造。

概念解释

显式定义覆盖默认推断:配置绑定、闭包、实例优先于反射自动装配。理解优先级有助于排查“为什么注入的是这个实现”。

原理流程

  1. 容器收到解析标识,先查显式绑定表。
  2. 命中绑定:按实现类/闭包/实例解析。
  3. 未命中:判断是否为可反射的具体类,是则构造函数自动解析。
  4. 接口或不可构造类未绑定,抛出解析异常。

代码或图示

// 显式绑定覆盖默认反射解析
return [
    LoggerInterface::class => CustomLogger::class,
];

常见误区

  • 以为接口会自动绑定到同名实现:框架不做约定式猜测,必须显式配置。
  • 多个配置文件重复绑定同一标识:后加载配置的覆盖关系需结合配置合并顺序确认(待确认)。

追问

  • 自动绑定(auto_binding)是什么?答:部分版本提供类名到实现的自动绑定开关;行为与配置项名以当前版本文档为准(待确认)。
  • 解析失败先查什么?答:先查接口是否有绑定,再查构造函数参数类型与默认值,最后看依赖自身能否被构造。

06.5.5.2-010 构造函数中的标量参数如何处理?

一句话结论

容器只能自动解析类类型参数;标量参数必须有默认值,或通过工厂闭包、配置定义显式传入,不能指望容器凭空提供。

概念解释

业务对象的端口、开关、阈值等标量属于配置数据,不应硬编码在类里。正确做法是在工厂闭包中读取配置后传入构造函数,或让类通过配置注解/方法获取。

原理流程

  1. 反射构造函数识别参数类型与是否可选。
  2. 类类型参数递归注入。
  3. 标量可选参数使用默认值;必填标量进入工厂定义。
  4. 工厂闭包从配置仓库取值并组装对象。

代码或图示

// 工厂闭包读取配置后传入标量参数(闭包签名以版本为准,待确认)
$container->set(TimeoutClient::class, function ($container) {
    $timeout = (float) config('client.timeout', 3.0);
    return new TimeoutClient($timeout);
});

常见误区

  • 构造函数必填标量参数且无默认值:容器解析直接失败。
  • 在类内硬编码环境相关阈值:应走配置注入,便于多环境切换。

追问

  • 配置值怎么注入到属性?答:可用 #[Value('config.key')] 注解注入配置项(命名空间 Hyperf\Config\Annotation\Value,待确认)。
  • 标量参数能否从上下文取?答:构造期无请求上下文,请求态标量应在方法调用时传入,不要塞进构造函数。

06.5.5.2-011 闭包绑定与实例绑定分别适用什么场景?

一句话结论

闭包绑定用于需要组合依赖、读取配置或传参的复杂对象构造;实例绑定用于已构造好的共享对象(如自定义缓存实例),二者都是显式定义的形式。

概念解释

闭包是“工厂”:每次按定义执行创建逻辑;实例是“现成对象”:直接放入容器复用。选择依据是对象是否需要构造参数、是否需要延迟创建。

原理流程

  1. 闭包定义:容器调用闭包,传入容器上下文,返回对象。
  2. 实例定义:把已有对象注册到标识下,后续直接返回。
  3. 闭包内可解析其他依赖、读取配置。
  4. 实例绑定不参与后续自动构造。

代码或图示

// 闭包工厂:组装依赖与配置
$container->set(ReportExporter::class, function ($container) {
    return new ReportExporter($container->get(StorageClient::class));
});

// 实例绑定:直接注册共享对象
$container->set(Clock::class, new SystemClock());

常见误区

  • 闭包内持有请求态数据:闭包在解析期执行,不能访问请求上下文。
  • 实例绑定可变对象后又在运行期改其内部状态:单例共享状态会被所有协程看到。

追问

  • 闭包工厂每次都新建对象吗?答:取决于容器缓存策略;返回实例是否被缓存复用需对照容器实现(待确认)。
  • 实例绑定适合单例资源吗?答:适合无状态或自带线程/协程安全管理的资源;连接池建议由组件按配置管理。

06.5.5.2-012 别名绑定有什么作用?

一句话结论

别名给同一注册对象起第二个标识名,便于按角色获取;接口实现与默认标识解耦后,别名可用于历史标识兼容或多实现区分。

概念解释

别名本质是标识到标识的映射,不产生新对象。重构期间类名调整时,别名可保留旧调用点解析到新实现,降低改动面。

原理流程

  1. 先注册主标识对应的实现或实例。
  2. 把别名指向主标识。
  3. 通过别名 get 时解析到同一对象。
  4. 移除别名需同步清理调用点。

代码或图示

// 别名映射的概念示例;具体注册方法名以容器源码为准(待确认)
$container->alias('default.logger', LoggerInterface::class);

常见误区

  • 别名注册成新实例:会出现两个不同对象,违背别名复用预期。
  • 长期保留大量历史别名:增加理解成本,应在重构完成后清理。

追问

  • 别名与接口绑定怎么选?答:面向抽象用接口绑定;兼容旧标识或按角色命名用别名。
  • 别名能指向闭包吗?答:取决于容器实现;通常别名指向已有标识,闭包应作为主定义注册(待确认)。

06.5.5.2-013 循环依赖在 Hyperf 容器中如何表现与处理?

一句话结论

构造函数互相注入形成闭环时容器无法完成解析,直接报循环依赖异常;属性注入或懒加载可打破构造期闭环,但根治方式是拆分职责、引入事件回调或中间协调层。

概念解释

构造循环:A 构造需要 B,B 构造需要 A,两者都无法先成型。属性循环可在双方构造完成后再互相赋值,懒加载则延迟到首次调用。框架层面的具体异常类与检测规则以源码为准。

原理流程

  1. 解析 A 构造函数,发现依赖 B。
  2. 解析 B 构造函数,又依赖 A,形成闭环。
  3. 容器检测到循环,抛出依赖解析异常。
  4. 重构:把互相调用的部分下沉到第三方服务或事件通知。

代码或图示

// 问题示范:构造函数双向依赖
class OrderService
{
    public function __construct(private PaymentService $payment) {}
}

class PaymentService
{
    public function __construct(private OrderService $order) {}
}

常见误区

  • 用懒加载或属性注入“消灭”报错而不拆职责:耦合仍然存在,后续维护更困难。
  • 把循环依赖当框架 bug:它是设计耦合的信号,应回到领域边界梳理。

追问

  • 事件机制如何解?答:一方发布事件,另一方监听处理,双方不再直接持有对方构造依赖。
  • 框架是否支持 setter 注入?答:可通过容器调用 setter 或属性注入实现;具体支持方式以当前版本定义语法为准(待确认)。

06.5.5.2-014 测试中如何替换容器里的依赖?

一句话结论

在测试引导阶段把接口绑定替换为 mock/stub 实例,被测对象从容器解析时拿到替身;替换在隔离的测试容器或测试 setUp 中完成,不污染生产容器配置。

概念解释

依赖接口是可替换的前提:测试绑定 mock 实现后,可断言交互、隔离外部下游。HTTP 层测试还可配合请求模拟,验证控制器编排逻辑。

原理流程

  1. 测试环境构建容器(或复用框架测试容器)。
  2. 在 setUp 中把下游接口 set 为 mock 实例。
  3. 解析被测服务,断言其调用了预期方法。
  4. 测试结束清理绑定,避免用例间串扰。

代码或图示

public function testCreateOrder(): void
{
    $mock = Mockery::mock(PaymentServiceInterface::class);
    $mock->shouldReceive('pay')->once()->andReturn(true);
    $this->container->set(PaymentServiceInterface::class, $mock);

    $service = $this->container->get(OrderService::class);
    self::assertTrue($service->create(['goods' => 1]));
}

常见误区

  • 在生产配置文件里写测试替换:mock 不应进入生产容器定义。
  • 用例间共享 mock 绑定:前一个用例的替身影响后一个,需在 tearDown 重置。

追问

  • 没有接口的类怎么 mock?答:可使用 mock 框架生成子类替身;或先重构出接口边界。具体 Mock 集成方式以项目测试依赖为准。
  • 容器替换能覆盖 new 出来的对象吗?答:不能,new 不经过容器;要可测就必须让对象从容器解析。

06.5.5.2-015 注解注入对 new 出来的对象生效吗?

一句话结论

不生效。#[Inject] 与构造自动注入都由容器在解析流程中完成;直接 new 的对象跳过容器,属性保持未注入状态,容易出现空属性错误。

概念解释

容器创建对象前会先做依赖计划收集,new 路径没有这一步。需要注入的类必须通过容器、容器创建的控制器/服务间接获取,或在工厂里手动赋值。

原理流程

  1. 容器路径:解析类 → 构造注入 → 属性注入 → 返回对象。
  2. new 路径:直接调用构造函数,跳过注解收集与注入。
  3. 访问未注入属性时触发未初始化或 null 错误。
  4. 排查:搜索代码中的 new 服务类,改为容器获取或注入点传入。

代码或图示

// 错误:new 出来的控制器/服务不会完成 Inject 注入
$controller = new OrderController();

// 正确:从容器解析,注入流程完整执行
$controller = ApplicationContext::getContainer()->get(OrderController::class);

常见误区

  • 在工具类里 new 服务后调用其注入属性:属性为 null,报调用错误。
  • 认为只要类上有注解,任何创建方式都生效:注解生效依赖容器创建路径。

追问

  • 控制器为什么默认是容器创建的?答:路由分发由框架容器解析控制器实例,因此控制器注解注入天然生效。
  • 必须手动创建对象时怎么办?答:在工厂里显式解析依赖并传入构造函数或赋值属性,不依赖框架注解流程。

06.5.5.2-016 容器返回的对象与 AOP 代理是什么关系?

一句话结论

被切面切入的类,容器返回的是框架生成的代理对象,而非原始类实例;代理转发到原方法并织入切面逻辑,业务通过容器获取时拿到代理。

概念解释

代理在启动期按切面规则生成并缓存。这也是为什么被切入类必须由容器创建:只有容器返回代理,切面才挂得上;new 的对象没有代理包装。

原理流程

  1. 扫描期确定哪些类被切面规则命中。
  2. 为命中类生成代理类代码,写入代理缓存目录。
  3. 容器解析时返回代理实例。
  4. 方法调用经代理执行切面链,再调用原方法。

代码或图示

// 命中日志切面的服务,容器返回的是代理对象
$service = $container->get(UserService::class);
// 调用方法时代理先执行切面逻辑,再转发到 UserService 原方法
$service->refresh(1);

常见误区

  • 对代理对象做严格类类型判断(如 instanceof 原始类失败):代理通常继承或实现原类型,具体关系以代理实现为准(待确认)。
  • 以为切面只对控制器生效:服务、模型等被规则命中的容器对象都会被代理。

追问

  • 代理类缓存在哪里?答:runtime/container/proxy/ 目录;代码变更后需清理重建。
  • 怎么确认代理已生成?答:查看代理目录是否存在对应类文件,或在切面内打断点/日志确认拦截进入。

06.5.5.2-017 依赖自动解析失败的常见原因有哪些?

一句话结论

常见原因包括:接口未绑定实现、构造函数必填标量无默认值、依赖自身不可构造、类未被扫描纳入容器、循环依赖,以及注入类型写错。

概念解释

解析失败信息通常指向具体参数与类名。按“绑定 → 构造参数 → 类可构造性 → 扫描范围 → 循环链”的顺序排查,比反复重启更高效。

原理流程

  1. 看异常指向的类与参数,确认标识是接口还是具体类。
  2. 接口查 dependencies.php 是否有绑定。
  3. 构造函数检查参数类型、默认值与标量来源。
  4. 确认类在扫描路径内,且无未解析的上游依赖或闭环。

代码或图示

// 排查示例:打印容器中已注册标识(方法名以版本为准,待确认)
var_dump($container->has(PaymentServiceInterface::class));

常见误区

  • 一失败就清缓存重启:多数解析问题是配置或代码问题,清缓存不能修复缺失绑定。
  • 忽略异常链上的根因类:只看最外层消息会误判出错位置。

追问

  • 类在 app/ 下却没被扫描到?答:检查注解扫描路径配置,确认目录被 scan.paths 覆盖。
  • 自动加载找不到类?答:先确认 Composer 自动加载映射与命名空间是否匹配,再排查容器解析。

06.5.5.2-018 为什么请求级对象不能注册成单例并保存请求状态?

一句话结论

单例在进程内被所有协程共享,保存用户 ID、请求体等请求态数据会导致跨协程污染;请求级数据应放在协程上下文,单例只持有无状态行为与连接池等进程级资源。

概念解释

容器单例生命周期等于进程生命周期,而请求数据生命周期等于协程。把两者混在同一对象上,并发下后写覆盖先写,出现串号、越权等隐蔽问题。

原理流程

  1. 区分进程级资源:配置、客户端、连接池、无状态服务。
  2. 区分协程级数据:当前用户、请求参数、响应对象、追踪 ID。
  3. 协程级数据写入 Context,随协程结束回收。
  4. 单例方法只接收参数或从上下文读取,不写成员可变状态。

代码或图示

// 错误:单例服务保存当前请求用户
class AuthService
{
    private int $userId;

    public function setUserId(int $id): void { $this->userId = $id; }
}

// 正确:从上下文按需读取,不缓存成员状态
class AuthService
{
    public function userId(): int
    {
        return (int) Context::get('current_user_id', 0);
    }
}

常见误区

  • 把 FPM 时代“请求内 new 一次服务”的思路改成单例挂状态:FPM 进程不共享,常驻模型共享。
  • 用成员变量做方法间临时传值:应改为局部变量或参数返回。

追问

  • 单例里可以缓存什么?答:不可变配置、线程安全的客户端、连接池引用、无界策略下的只读缓存。
  • 请求对象本身为什么是单例包装?答:请求接口对象是单例代理,内部实际数据从 Context 读取,代理转发保证协程隔离,业务不要持有其内部可变状态。

06.5.5.2-019 dependencies.php 的整体结构是什么?

一句话结论

该文件返回一个数组,键为依赖标识(类名/接口名/别名),值为实现类名、闭包或实例;框架启动时把数组合并进容器绑定表。

概念解释

配置文件是声明式 DI 的主要入口:不需要写工厂类就能完成接口绑定。复杂构造再配合闭包工厂。文件只做绑定声明,不含业务执行逻辑。

原理流程

  1. 文件 return 一个配置数组。
  2. 每项标识对应一个定义。
  3. 启动期容器读取数组并注册。
  4. 运行期解析按绑定表查找定义。

代码或图示

// config/autoload/dependencies.php
return [
    // 接口 → 实现
    \App\Contract\OrderRepositoryInterface::class => \App\Repository\MysqlOrderRepository::class,
    // 闭包工厂
    \App\Client\NotifyClient::class => function ($container) {
        return new \App\Client\NotifyClient((float) config('notify.timeout', 2.0));
    },
];

常见误区

  • 在配置文件里写业务分支逻辑:配置应保持声明式,复杂组装放工厂类。
  • 键写字符串又与类名混用导致难以检索:统一优先使用 ::class 常量。

追问

  • 多个绑定文件如何合并?答:autoload 目录下配置按组件约定加载合并;同一标识的覆盖顺序以配置加载机制为准(待确认)。
  • 绑定可以删类不清理吗?答:实现类删除后绑定指向不存在类,解析时才暴露问题;应随重构同步清理。

06.5.5.2-020 如何为复杂对象编写工厂定义?

一句话结论

对需要多依赖组合、配置参数或条件分支的对象,用闭包工厂或独立工厂类在容器中注册,工厂负责组装,服务类只保留业务行为。

概念解释

复杂构造包括:读取多个配置项、组合下游客户端、按环境选择实现。工厂把装配代码集中在一处,避免污染服务构造函数;独立工厂类还可被单元测试直接实例化。

原理流程

  1. 识别对象构造所需的依赖与标量配置。
  2. 编写闭包或工厂类,从容器解析依赖、从配置取值。
  3. 在 dependencies.php 注册工厂。
  4. 业务侧只依赖目标接口,不感知组装细节。

代码或图示

// 独立工厂类示例
class ExportClientFactory
{
    public function __invoke($container): ExportClient
    {
        $endpoint = (string) config('export.endpoint');
        return new ExportClient($endpoint, $container->get(AuthClient::class));
    }
}

// dependencies.php 注册工厂
return [
    ExportClient::class => ExportClientFactory::class,
];

常见误区

  • 工厂内做请求期判断:工厂在解析期执行,读不到请求上下文;条件选择应基于配置而非请求态。
  • 工厂返回带可变状态的单例对象:确认对象生命周期与复用策略匹配用途。

追问

  • 工厂类与闭包怎么选?答:组装逻辑简单用闭包;逻辑较长、需测试或复用时抽独立工厂类。
  • 工厂能抛异常吗?答:可以,但解析期异常会导致启动或请求失败;可恢复的降级选择应在方法调用期处理。