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

06.5.4.1 服务容器与绑定解析

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

覆盖范围

  • bind / singleton / scoped / instance 四种绑定语义
  • 自动解析、反射注入与方法调用
  • 上下文绑定、别名、标签与扩展包装
  • 解析回调、缓存清理与循环依赖定位

基础概念见 06.5.1.1 框架架构与生命周期 中的服务容器入门题;本页聚焦容器内部绑定与解析机制。

06.5.4.1-001 bind 与 singleton 绑定的语义有何区别?

一句话结论

bind 每次解析都按工厂重新构造实例,singleton 首次解析后把实例缓存进容器,后续解析复用同一对象;状态是否跨解析共享是二者的根本分界。

概念解释

容器内部维护 bindings 与 instances 两张表。bind 注册的是构造规则(闭包或类名),不持有成品;singleton 在首次 make 后把成品写入 instances 表,等价于“规则 + 一次性缓存”。

原理流程

  1. bind($abstract, $concrete) 写入 bindings,标记非共享。
  2. 每次解析先查 instances,未命中则执行 concrete 工厂构造。
  3. singleton 构造完成后把结果写入 instances,再次解析直接取缓存。

代码或图示

$this->app->bind(Logger::class, fn () => new FileLogger(storage_path('log/app.log')));
$this->app->singleton(ConfigRepository::class, fn ($app) => new ConfigRepository($app['files']));

常见误区

  • 以为 singleton 只是“延迟创建”:它确实延迟到首次解析,但缓存的是同一个实例,状态会跨解析残留。
  • 把无状态工具类绑成 bind 也无性能问题:是否单例取决于对象是否需要共享状态,而不是类大小。

追问

  • 如何判断一个绑定是否共享?答:调用 $app->isShared($abstract),单例与 instance 绑定返回 true。
  • 单例里持有请求级数据有什么风险?答:常驻运行时下实例跨请求复用,请求数据可能泄漏到下一请求,请求级对象应使用 scoped 绑定。

06.5.4.1-002 scoped 绑定与 singleton 的生命周期差异是什么?

一句话结论

scoped 在一个作用域内复用实例,离开作用域后实例被清除;Web 请求中作用域通常是单次请求,常驻运行时下作用域按请求边界重置,因此比 singleton 更适合请求级单例。

概念解释

scoped 是介于 bind 与 singleton 之间的生命周期:同一作用域内只构造一次,作用域结束调用 forgetScopedInstances 清缓存。它解决常驻内存模式下单例残留请求状态的问题。具体作用域边界以当前框架版本与运行时为准,可在 Illuminate\Container\Container 源码中核对 scoped 与 forgetScopedInstances 的实现。

原理流程

  1. scoped($abstract, $concrete) 注册为作用域共享绑定。
  2. 作用域内首次解析构造实例并缓存,后续解析复用。
  3. 作用域结束时容器清除 scoped 缓存,下一作用域重新构造。

代码或图示

$this->app->scoped(RequestContext::class, fn ($app) => new RequestContext($app['request']));
// 作用域结束后由容器清理:
$this->app->forgetScopedInstances();

常见误区

  • 把请求级服务绑成 singleton:FPM 下因请求结束进程销毁问题不明显,Octane/Swoole 常驻下会出现跨请求数据串扰。
  • 以为 scoped 实例在整个进程生命周期内复用:它只在当前作用域内复用,出作用域即失效。

追问

  • scoped 与请求生命周期如何对应?答:Web 请求作用域由框架在请求开始/结束时划定;CLI 命令与队列任务各自形成独立作用域,具体触发点需核对当前版本内核代码。
  • 如何验证 scoped 缓存被清除?答:在两个解析点之间调用 forgetScopedInstances 后再次 make,对比返回实例的 === 结果。

06.5.4.1-003 instance 绑定与手动注册已有实例解决什么场景?

一句话结论

instance($abstract, $instance) 把一个已经构造好的对象直接放进容器 instances 表,解析时原样返回;适合配置对象、外部已初始化资源、测试替身等“成品注入”场景。

概念解释

与 bind/singleton 注册工厂不同,instance 绑定跳过工厂构造步骤,容器不关心对象如何创建。它是注册测试 mock、框架启动早期已存在对象的常用入口。

原理流程

  1. 业务代码先自行构造好对象。
  2. 调用 instance 把对象与抽象标识登记到容器。
  3. 后续 make 或类型注入直接返回该实例,标记为共享。

代码或图示

$config = new ConfigRepository(require config_path('app.php'));
$this->app->instance('config', $config);
// 测试中替换:
$this->app->instance(PaymentGateway::class, Mockery::mock(PaymentGateway::class));

常见误区

  • 用 instance 注册每次都需要新状态的对象:实例被容器长期持有,后续修改状态会影响所有解析方。
  • 在 instance 绑定后又调用 bind 覆盖:后注册的规则只改 bindings,已缓存的 instances 不会自动替换,需要先 forgetInstance。

追问

  • instance 绑定算单例吗?答:算,isShared 返回 true,因为容器持有的是同一个成品。
  • 如何替换已注册的 instance?答:先 $app->forgetInstance($abstract) 再重新 instance,或直接再次 instance 覆盖 instances 表。

06.5.4.1-004 容器如何通过反射自动解析类依赖?

一句话结论

当抽象标识对应一个具体类且没有显式工厂时,容器用反射读取构造函数参数类型,递归解析每个参数,再 newInstanceArgs 构造对象;这就是“自动解析”(automatic resolution)。

概念解释

自动解析依赖反射 API:ReflectionClass、ReflectionParameter。容器能识别类/接口类型提示,对基本类型、可变参数、无类型参数无法自动推断,需要上下文绑定或工厂闭包显式提供。

原理流程

  1. make($abstract) 查不到现成实例,取其 concrete 类名。
  2. 反射构造函数,逐个读取参数类型提示。
  3. 类类型参数递归 make;接口类型走已注册绑定;无法推断的参数抛绑定异常。
  4. 用解析出的参数数组实例化类。

代码或图示

class OrderService
{
    public function __construct(
        private readonly Repository $repo,
        private readonly EventDispatcher $events,
    ) {}
}
// 容器自动注入 Repository 与 EventDispatcher:
$service = $this->app->make(OrderService::class);

常见误区

  • 以为构造函数里的标量参数(如 int $timeout)也能自动注入:容器无法推断标量取值,必须用工厂闭包或上下文绑定提供。
  • 在构造函数中做 IO 或重逻辑:自动解析会在每次构造时执行,复杂初始化应延迟到方法调用。

追问

  • 接口参数如何被解析?答:容器按接口名查 bindings,找到绑定的具体实现或闭包后再解析。
  • 自动解析失败抛什么异常?答:通常抛出 Illuminate\Contracts\Container\BindingResolutionException,异常信息会指出无法解析的参数与所属类。

06.5.4.1-005 构造函数注入与方法注入(call)如何由容器完成?

一句话结论

构造函数注入在对象解析时由容器反射构造器完成;方法注入通过 $app->call($callback, $parameters) 反射目标方法,按类型提示解析参数后调用,常用于控制器动作、闭包路由与回调分发。

概念解释

call 是容器的“方法级自动解析”能力:它不创建对象,只解析方法参数。控制器动作、事件监听器、队列任务的 handle 方法都经过类似的参数解析流程。

原理流程

  1. 构造注入:make 时反射构造器参数并递归解析,再实例化。
  2. 方法注入:call 接收闭包/类方法/可调用数组。
  3. 反射方法签名,类型提示参数由容器解析,显式传入的 $parameters 优先。
  4. 调用目标方法并返回其返回值。

代码或图示

// 构造注入
class UserController
{
    public function __construct(private readonly UserRepository $users) {}
}

// 方法注入:容器解析 Request 与路由参数 {id}
$response = $this->app->call(function (Request $request, string $id) {
    return $this->users->find($id);
});

常见误区

  • 以为方法参数顺序必须与路由参数一致:容器按类型提示与参数名匹配,路由参数按名注入,类型提示按类型解析。
  • 在 call 的 $parameters 里传对象又让容器解析同名类型:显式参数优先,容器不会覆盖。

追问

  • 控制器动作参数解析走的是容器吗?答:路由分发通过容器的 call 机制解析动作方法参数,模型绑定结果也作为参数传入。
  • 闭包路由如何注入依赖?答:闭包参数同样经过容器解析,类型提示自动注入 Request、已绑定服务等。

06.5.4.1-006 接口到实现如何绑定,消费方依赖接口时解析谁?

一句话结论

把接口名作为 abstract、实现类或工厂作为 concrete 注册到容器,消费方类型提示写接口,解析时容器按接口名查到绑定并构造实现;更换实现只需改绑定处。

概念解释

面向接口依赖是容器解耦的核心用法:业务代码依赖契约,具体实现可在服务提供者中替换,测试时也能绑定 mock。契约清单见 06.5.4.3 Facade 与契约 Contracts。

原理流程

  1. 定义契约接口,例如 PaymentGateway。
  2. 在提供者 register 中 bind(PaymentGateway::class, StripeGateway::class)。
  3. 消费方构造器类型提示 PaymentGateway。
  4. 容器按接口名查绑定,解析出 StripeGateway 实例注入。

代码或图示

$this->app->bind(PaymentGateway::class, StripeGateway::class);

class CheckoutService
{
    public function __construct(private readonly PaymentGateway $gateway) {}
}

常见误区

  • 消费方直接类型提示实现类:失去接口替换能力,测试替身也需要继承实现类。
  • 只在某个环境绑定接口:其他环境缺少绑定时自动解析会因接口无法实例化而抛异常。

追问

  • 同一接口能否绑定多个实现并按名区分?答:可以用不同 abstract 标识(接口名 + 别名)分别绑定,消费方按标识解析;批量实现用标签组织。
  • 绑定延迟到什么时候?答:bind 只登记规则,真正构造发生在首次解析时。

06.5.4.1-007 上下文绑定(contextual binding)解决什么问题?

一句话结论

上下文绑定让“同一个接口在不同消费方注入不同实现”:用 when($concrete)->needs($abstract)->give($implementation) 为特定类定制依赖,解决多实现场景下的定向注入。

概念解释

普通接口绑定是全局唯一的;当 A 类需要短信网关、B 类需要邮件网关,而二者都依赖同一通知接口时,就需要上下文绑定。规则记录在容器的 contextual 数组中,解析到目标类时优先查定向规则。

原理流程

  1. when(OrderNotifier::class) 指定消费方。
  2. needs(NotificationSender::class) 指定所需抽象。
  3. give(SmsSender::class) 给出定向实现或工厂。
  4. 解析 OrderNotifier 构造参数时,容器按上下文规则选择 SmsSender。

代码或图示

$this->app->when(OrderNotifier::class)
    ->needs(NotificationSender::class)
    ->give(SmsSender::class);

$this->app->when(MarketingNotifier::class)
    ->needs(NotificationSender::class)
    ->give(MailSender::class);

常见误区

  • 用全局单例绑定硬塞多实现:所有消费方拿到同一实现,无法区分渠道。
  • 把上下文绑定写在消费方类里:绑定属于装配层,应放在服务提供者,业务类只依赖接口。

追问

  • give 能否传闭包?答:可以,give 接受实现类名、闭包或已注册的抽象标识,闭包由容器调用并传入容器实例。
  • 上下文绑定对方法注入生效吗?答:上下文规则主要作用于构造函数解析;方法级 call 的定向注入需通过显式参数或单独工厂处理,具体行为以容器源码为准。

06.5.4.1-008 别名(alias)与绑定标识是什么关系?

一句话结论

别名给已有绑定起一个短名或类别名,alias($abstract, $alias) 建立双向映射;解析别名时容器沿别名表找到原始抽象,再按原绑定解析。

概念解释

容器内部维护 aliases 数组,别名可以指向类名、接口名或另一个别名。Facade 访问、配置中的服务名很多都通过别名映射到真实绑定标识。

原理流程

  1. 先注册原始绑定,例如 singleton(ConfigRepository::class, ...)。
  2. alias(ConfigRepository::class, 'config') 登记别名。
  3. make('config') 先查别名表还原为 ConfigRepository::class,再走正常解析。

代码或图示

$this->app->alias(ConfigRepository::class, 'config');
$this->app->alias(Encrypter::class, 'encrypter');

$config = $this->app->make('config');

常见误区

  • 以为别名是独立绑定:别名只是名称映射,删除原始绑定后别名解析会失败。
  • 别名与原始名互相循环指向:解析时沿别名链查找,循环别名会导致解析异常,应避免。

追问

  • Facade 如何利用别名?答:Facade 的 getFacadeAccessor 返回的标识通常就是容器别名或绑定名,静态调用经别名解析到底层实例。
  • 如何判断一个名字是不是别名?答:容器提供 getAlias($abstract) 方法返回最终原始标识;具体方法名以当前版本容器源码为准。

06.5.4.1-009 tag 与 tagged 如何按标签批量解析一组实现?

一句话结论

tag($abstracts, $tags) 给绑定打标签,tagged($tag) 返回该标签下所有实现的集合;适合策略集合、处理器列表、可插拔扩展点等“一组同接口实现”场景。

概念解释

标签是容器的分组机制:多个实现绑定到同一标签后,消费方注入标签解析出的集合,遍历调用共同接口,新增实现时只需补打标签,不改消费方代码。

原理流程

  1. 分别绑定各实现,或先绑定后补标签。
  2. tag([Foo::class, Bar::class], 'report.handlers') 登记标签映射。
  3. 消费方通过 tagged('report.handlers') 取得实现数组。
  4. 遍历数组调用共同接口方法。

代码或图示

$this->app->tag([CsvReport::class, PdfReport::class], 'report.handlers');

class ReportRunner
{
    public function __construct(private readonly iterable $handlers) {}

    public function run(): void
    {
        foreach ($this->handlers as $handler) {
            $handler->generate();
        }
    }
}
// 注入标签集合:
$runner = new ReportRunner($this->app->tagged('report.handlers'));

常见误区

  • 标签内实现类型不一致:遍历调用方法时会因缺少共同方法而报错,应先约束同一契约接口。
  • 以为 tagged 返回集合对象:实际返回数组(或可迭代结果),类型声明用 iterable 最稳妥。

追问

  • 标签实现顺序如何控制?答:顺序按绑定登记顺序,显式排序应在消费方或工厂中处理;容器不保证标签内的调用优先级。
  • 标签绑定支持延迟解析吗?答:tagged 遍历时才逐个解析对应实现,未被遍历的实现不会被构造。

06.5.4.1-010 extend 如何在不替换原绑定的前提下包装解析结果?

一句话结论

extend($abstract, $closure) 在原有解析结果返回前包一层装饰:闭包接收原实例与容器,返回增强后的对象;原绑定规则保留,包装逻辑对所有解析方生效。

概念解释

extend 是容器级装饰器注册点,常用于给核心服务加日志、缓存、权限拦截等横切行为。它与重新 bind 的区别是不推翻原始构造规则。

原理流程

  1. 原始绑定先注册完成。
  2. extend 登记包装闭包到对应抽象。
  3. 每次解析先得到原实例,再依次经过包装闭包处理后返回。

代码或图示

$this->app->singleton(PaymentGateway::class, StripeGateway::class);

$this->app->extend(PaymentGateway::class, function ($gateway, $app) {
    return new LoggingGateway($gateway, $app['log']);
});

常见误区

  • 在 register 阶段先 extend 再绑定:包装闭包依赖原始实例,应确保原绑定已注册;顺序问题以提供者启动顺序为准。
  • 包装闭包内直接 new 替代原对象:会绕过原绑定,失去 extend 的装饰语义。

追问

  • 多个 extend 如何叠加?答:后注册的包装在外层还是内层以容器源码的调用顺序为准,堆叠装饰时应在测试中核对实际调用链。
  • extend 影响单例缓存吗?答:包装结果随原实例一起被缓存,单例下只包装一次;具体缓存时机需核对当前版本 extend 实现。

06.5.4.1-011 resolved 与 afterResolving 回调在什么时机触发?

一句话结论

resolved 对每次解析完成的抽象触发回调,afterResolving 是其按抽象注册的形式;回调在实例构造完成、即将返回给解析方时执行,可做后置初始化、事件订阅等。

概念解释

容器提供解析完成钩子:注册闭包后,对应抽象每次解析成功都会被调用一次。单例只在首次构造后触发,后续取缓存是否再次触发需以当前版本源码为准。

原理流程

  1. 注册回调:resolved(Closure) 或 afterResolving($abstract, Closure)。
  2. 实例解析完成后,容器遍历该抽象的回调列表。
  3. 回调接收实例与容器,可修改实例或登记副作用。

代码或图示

$this->app->afterResolving(Logger::class, function ($logger, $app) {
    $logger->setLevel($app['config']->get('app.log_level'));
});

$this->app->resolved(function ($object, $app) {
    // 任意抽象解析完成后的通用钩子
});

常见误区

  • 在回调里再次 make 同一抽象:可能造成递归解析,需要时先取出已解析实例避免重入。
  • 把重逻辑放进 resolved 钩子:每次解析都会执行,高频服务会累积成本。

追问

  • resolved 钩子与模型事件有何区别?答:容器钩子作用于对象解析时机,模型事件作用于 Eloquent 数据生命周期,两者层级不同。
  • 如何取消已注册的解析回调?答:容器一般不提供单个回调的反注册入口;需要条件化执行应在闭包内部判断,具体 API 以源码为准。

06.5.4.1-012 绑定闭包与可调用工厂如何延迟创建对象?

一句话结论

bind/singleton 的 concrete 可以是无参或接收容器的闭包,容器在解析时才调用闭包构造对象;闭包把复杂装配逻辑延迟到首次使用,避免引导阶段提前初始化重资源。

概念解释

闭包工厂是容器最灵活的绑定形式:内部可以读取配置、组合多个依赖、条件选择实现。容器调用闭包时把自身作为第一个参数传入。

原理流程

  1. 注册时传入闭包,不立即执行。
  2. 首次解析触发闭包,容器实例作为参数注入。
  3. 闭包内组合依赖并返回成品。
  4. singleton 场景下成品写入缓存,后续不再调用闭包。

代码或图示

$this->app->bind(ReportExporter::class, function ($app) {
    $format = $app['config']->get('report.format');
    return match ($format) {
        'pdf' => new PdfExporter($app['files']),
        default => new CsvExporter($app['files']),
    };
});

常见误区

  • 闭包内读取尚未注册的服务:register 阶段只登记不解析,若闭包在注册时被误调用会取不到依赖。
  • 闭包内持有外部可变状态:工厂闭包被多次调用时外部状态可能不一致,依赖应从容器或配置获取。

追问

  • concrete 为类名与闭包有何区别?答:类名走反射自动解析;闭包完全自定义构造过程,适合有条件分支或参数加工的场景。
  • 工厂闭包能否返回接口实现?答:可以,返回值类型只要满足消费方类型提示即可。

06.5.4.1-013 如何判断绑定是否存在、是否共享?

一句话结论

bound($abstract) 判断抽象是否已注册或已有实例,has($abstract) 是其同义判断入口;isShared($abstract) 判断是否为单例或 instance 绑定。

概念解释

排查“容器里到底有没有这个服务”时,先查 bindings 与 instances,再沿别名表还原。判断方法用于防御性编程与测试中断言绑定状态。

原理流程

  1. bound 检查 bindings、instances 与别名解析后的原始标识。
  2. isShared 检查该标识是否在共享列表或 instances 表中。
  3. 不存在的标识 make 会尝试自动解析具体类,接口/标量则抛解析异常。

代码或图示

if ($this->app->bound(PaymentGateway::class)) {
    $gateway = $this->app->make(PaymentGateway::class);
}

$shared = $this->app->isShared(ConfigRepository::class);

常见误区

  • 把 bound 当作“已有成品实例”:它只表示规则或实例至少存在其一,成品是否已构造需查 instances。
  • 别名未还原就判断 bound:直接判断别名可能漏判,应先经别名解析。

追问

  • 如何列出当前所有绑定?答:容器提供 getBindings()、getInstances() 等读取方法(具体方法名以当前版本源码为准),调试时可导出抽象标识清单。
  • 自动解析的类会出现在 bindings 里吗?答:不会显式登记,只有注册过的规则才进入 bindings;自动解析在 make 时现场完成。

06.5.4.1-014 forgetInstance 与 flush 何时需要手动清理容器缓存?

一句话结论

forgetInstance($abstract) 清除单个已缓存实例,flush() 清空所有 instances 与解析缓存;常规请求由框架在请求边界清理,测试隔离、常驻运行时状态重置、手动替换单例时才需要调用。

概念解释

单例缓存是内存中的对象表。测试间若不清理,前一用例的 mock 或状态会泄漏到下一用例;常驻运行时请求边界也需要重置请求级单例。

原理流程

  1. 定位需要失效的抽象标识。
  2. 单个失效:forgetInstance 删除 instances 表对应项。
  3. 整体重置:flush 清空实例缓存与已解析标记。
  4. 下次解析按绑定规则重新构造。

代码或图示

// 测试隔离:每个用例后清缓存
$this->app->forgetInstance(PaymentGateway::class);

// 整体重置
$this->app->flush();

常见误区

  • 在业务请求中频繁 flush:会销毁所有单例缓存,导致配置、日志等核心服务重建,性能与副作用都不可控。
  • 替换单例前忘记 forgetInstance:旧实例仍在缓存中,新绑定不生效。

追问

  • FPM 下需要手动 flush 吗?答:FPM 每个请求独立进程,请求结束内存自然释放;手动清理主要用于测试与常驻运行时。
  • flush 会删除绑定规则吗?答:flush 清的是已解析实例缓存,bindings 规则是否保留需以容器源码为准;重新注册绑定不应依赖 flush 行为。

06.5.4.1-015 循环依赖在容器解析时如何暴露与定位?

一句话结论

A 构造依赖 B、B 构造又依赖 A 时,容器递归解析会沿依赖链重复进入同一类,最终抛出解析异常或达到解析栈上限;定位手段是查看异常链中的类名与构造参数。

概念解释

构造函数层面的循环依赖无法靠容器自动打破,因为实例化任何一方前都需要另一方先存在。解决方案是改为方法注入、事件/回调解耦,或引入第三者持有共享状态。

原理流程

  1. 解析 A → 构造参数需要 B。
  2. 解析 B → 构造参数需要 A。
  3. 容器再次解析 A,形成递归环。
  4. 触发解析异常或栈溢出,异常记录重复出现的类名。

代码或图示

class OrderService
{
    public function __construct(private readonly InvoiceService $invoices) {}
}
class InvoiceService
{
    public function __construct(private readonly OrderService $orders) {}
}
// 解析 OrderService 时进入循环,需改为方法注入或抽取共享依赖

常见误区

  • 试图用 singleton 解决循环依赖:单例只缓存成品,循环发生在构造阶段,成品尚未产生,缓存帮不上忙。
  • 把一方依赖改成可选参数(nullable)绕过:环未真正解除,空依赖在调用时仍会出错。

追问

  • 方法注入能打破构造环吗?答:可以,把环上一方的依赖改为方法内 app()->call 或延迟获取,构造期不再互相持有。
  • 如何在设计阶段发现环?答:梳理服务构造依赖图,出现闭合环即标记;IDE 的依赖关系分析与容器异常日志可辅助定位。

06.5.4.1-016 app() 辅助函数与容器静态门面如何拿到容器实例?

一句话结论

app() 返回全局 Application 实例(容器本身),app('abstract') 等价于 $container->make('abstract');容器在应用创建时即存在,辅助函数是访问它的最简入口。

概念解释

Application 继承自容器实现类,自身既是容器又是应用内核。辅助函数读取静态绑定的应用实例, Facade 中的 App 门面也转发到同一容器。

原理流程

  1. 入口脚本创建 Application 实例并保存为全局静态实例。
  2. app() 无参时返回该实例。
  3. app($abstract) 调用容器 make 解析并返回对象。

代码或图示

$container = app();
$logger = app('log');
$users = app(UserRepository::class);

// 容器内部解析控制器时同样调用 make:
$controller = app()->make($controllerClass);

常见误区

  • 在类中到处调用 app() 取依赖:等价于服务定位器,隐藏了真实依赖,应优先构造函数注入。
  • 以为 app() 每次返回新容器:它返回的是同一个应用实例,容器全局唯一。

追问

  • app() 与 resolve() 辅助函数区别?答:两者都是容器解析入口,语义一致;resolve 命名更强调解析动作,具体别名以框架助手函数源码为准。
  • 容器实例如何在 Facade 中暴露?答:App Facade 的 accessor 指向应用容器,静态调用转发到 Application 实例。

06.5.4.1-017 构造参数为标量或数组时,容器如何提供取值?

一句话结论

标量、数组、无类型提示的参数无法反射推断,必须通过工厂闭包读取配置后传入,或用上下文绑定的 give 给出字面值;容器不会自动猜测数字与字符串取值。

概念解释

自动解析只对类/接口类型提示有效。需要配置项(超时时间、渠道名、目录路径)时,正确做法是在闭包工厂内从配置仓库取值组装。

原理流程

  1. 绑定工厂闭包,闭包接收容器实例。
  2. 闭包内读取配置、环境变量或常量。
  3. 把标量/数组作为构造参数传入实现类。
  4. 消费方只依赖实现类,不感知取值来源。

代码或图示

$this->app->bind(HttpClient::class, function ($app) {
    $timeout = $app['config']->get('http.timeout', 5);
    $baseUri = $app['config']->get('http.base_uri');
    return new HttpClient($baseUri, $timeout);
});

常见误区

  • 在构造函数里直接读 config():业务类绕过容器装配,配置变更难以测试与替换。
  • 让容器自动注入 string $channel:无类型来源,解析时抛 BindingResolutionException。

追问

  • 上下文绑定能给标量参数定值吗?答:needs 通常按抽象标识匹配,标量参数更适合工厂闭包处理;give 传字面值的适用范围以容器源码为准。
  • 配置缺失时怎么办?答:工厂内提供默认值并记录日志,避免构造期直接抛错导致引导失败。

06.5.4.1-018 容器解析失败抛什么异常,如何定位缺失绑定?

一句话结论

无法解析时抛出 Illuminate\Contracts\Container\BindingResolutionException(或其容器实现子类),消息包含目标类、无法推断的参数与类型;排查路径是先查绑定注册,再查构造函数类型提示与上下文规则。

概念解释

解析失败常见原因:接口未绑定、标量参数未提供、类不存在、依赖链中某一环缺失。异常消息会指出失败发生在哪个类的哪个参数。

原理流程

  1. 复现解析点,记录异常类与消息。
  2. 检查目标抽象是否在服务提供者中绑定。
  3. 反射构造函数参数,确认每个类型提示都有对应绑定。
  4. 接口缺失则补绑定,标量缺失则改工厂闭包。

代码或图示

try {
    $service = app(OrderService::class);
} catch (BindingResolutionException $e) {
    // 输出失败链路:目标类、参数类型、缺失的抽象
    report($e->getMessage());
}

常见误区

  • 只看最外层异常消息:依赖链深层失败会包装在外层异常下,应遍历 previous 异常定位根因类。
  • 在测试中用真实容器复现后才排查:可在隔离测试中直接 make 目标类,更快暴露缺失绑定。

追问

  • 类文件不存在会抛什么?答:自动解析时类加载失败通常表现为 ReflectionException 或类未找到错误,需先核对自动加载与命名空间。
  • 如何列出未绑定的接口依赖?答:开启查询/解析日志,或在测试中逐个 make 核心服务,记录抛出 BindingResolutionException 的抽象。

06.5.4.1-019 单例状态在 FPM 与常驻运行时下有什么差异?

一句话结论

FPM 下请求结束进程销毁,单例状态不跨请求;Octane/Swoole/RoadRunner 常驻进程复用 worker,单例与静态属性跨请求保留,请求级状态混入单例会造成串数据。

概念解释

容器缓存的生命周期与进程绑定。FPM 每请求重建应用与容器;常驻模式应用实例与容器在 worker 内复用,单例缓存需要按请求边界重置,scoped 绑定正是为此设计。

原理流程

  1. FPM:请求 → 启动进程 → 构建容器与单例 → 响应 → 进程回收,状态不残留。
  2. 常驻:worker 常驻 → 容器复用 → 单例跨请求保留。
  3. 请求开始/结束时框架重置请求级绑定与作用域缓存。
  4. 把请求数据写进单例属性会被下一请求读到。

代码或图示

// 风险写法:单例持有当前请求用户
class SessionHolder
{
    public ?User $currentUser = null;
}
// 常驻模式下 currentUser 会跨请求残留,应改为 scoped 或方法参数传递

常见误区

  • 在 FPM 经验下直接迁移到常驻模式:单例缓存、静态变量、全局数组的行为都会变化。
  • 单例中缓存连接类资源:数据库/Redis 连接在常驻模式下需要处理断开重连,不能假设每请求重建。

追问

  • 常驻模式如何隔离请求状态?答:请求对象本身按请求重建,请求级服务使用 scoped 绑定;避免把请求数据存进进程级单例。Octane 的具体隔离机制以其官方文档为准。
  • 如何排查跨请求串数据?答:对比相邻请求的单例属性,在请求结束钩子检查残留对象;必要时在请求边界重置相关实例。

06.5.4.1-020 绑定写在服务提供者与在控制器中直接 make 的边界是什么?

一句话结论

装配规则(绑定、别名、标签、上下文)属于引导层,写在服务提供者;控制器/业务类只声明依赖类型,不在内部 make 取服务;直接 app()->make 仅用于无法构造注入的边缘场景。

概念解释

容器绑定是“谁负责创建”的决策,业务代码是“谁使用”的消费方。把 make 散落在业务类中等于服务定位器,依赖关系不可见、不可测。

原理流程

  1. 服务提供者 register 中完成全部绑定登记。
  2. 控制器/服务通过构造函数声明所需类型。
  3. 容器在分发与解析时注入实现。
  4. 业务代码不出现容器解析调用,例外处保留注释说明原因。

代码或图示

// 提供者:装配
$this->app->bind(NotificationSender::class, MailSender::class);

// 控制器:只声明依赖
class NotificationController
{
    public function __construct(private readonly NotificationSender $sender) {}
}

常见误区

  • 在控制器构造函数里 app()->make(...) 再赋值:依赖被隐藏,单元测试无法直接传替身。
  • 把 new 出来的对象再 instance 注册到容器:装配逻辑分散到业务层,包复用与测试都困难。

追问

  • 哪些场景允许直接 make?答:无法通过构造注入的回调工厂、动态选择实现的策略解析点;其余场景应回到构造注入。
  • 提供者中能否直接调用其他服务?答:register 阶段只登记绑定;需要其他服务实例的初始化放 boot 阶段,详见 06.5.4.2 服务提供者与启动引导。