第三方类必须先能被自动加载，否则 bind 会静默失败；绑定须在 app/bootstrap.php 或服务提供者中进行，禁用 common.php；应据 SDK 特性选 bind() 或 singleton()；获取实例必须通过容器解析。
第三方类必须先能被自动加载，否则 bind 会静默失败
ThinkPHP 容器不负责类的加载，只负责实例化。如果 class_exists('Aliyun\Sms\Client') 返回 false，后续任何 bind() 都不会生效，也不会报错——这是最常被忽略的前提。
确认方式很简单：在控制器或命令行里执行该语句；返回 true 才算就绪。
- 若用 Composer 包（如
aliyun-openapi-php-sdk），确保已运行composer require aliyun/openapi-php-sdk，且其 PSR-4 映射已写入vendor/composer/autoload_psr4.php - 若 SDK 放在
extend/aliyun-sms/下，需手动在composer.json的"autoload": {"psr-4": {}}中添加映射，再执行composer dump-autoload -o - 绝对不要靠
require_once或include补救——容器解析时不会触发这些语句
绑定必须在应用上下文确定后进行，common.php 是雷区
common.php 在框架初始化前就被加载，此时 Container::getInstance() 返回的是一个“裸”容器，没有应用生命周期管理，后续 App 初始化会覆盖它。所有绑定都会丢失。
正确位置只有两个：
立即学习“PHP免费学习笔记（深入）”；
-
app/bootstrap.php末尾（适用于全局、无依赖的简单绑定，如Container::getInstance()->bind('sms_client', \extend\aliyun\SmsClient::class)） - 自定义服务提供者（推荐）：执行
php think make:provider AliyunSmsServiceProvider，在register()方法中调用$this->app->bind()或$this->app->singleton()
服务提供者需在 config/app.php 的 'providers' 数组中注册，否则不会被执行。
bind() 和 singleton() 的区别不是“要不要单例”，而是“能不能复用”
第三方 SDK 是否允许重复实例化，决定了你该用哪个方法。这不是风格选择，是资源安全问题。
- 用
singleton()：HTTP 客户端（如 Guzzle 封装类）、Redis 连接池、微信支付 SDK 实例——它们内部持有连接、token 或上下文，多次 new 会导致连接耗尽或状态错乱 - 用
bind()：纯数据类（DTO）、无状态工具类（如字符串格式化器）、策略类——每次请求都应全新实例，避免属性污染 - 别用
instance()：除非你明确知道要共享同一个对象引用，且该对象完全无状态、线程安全——99% 的场景不需要
示例：绑定阿里云短信客户端（带配置依赖）
$this->app->singleton('aliyun.sms', function ($app) {
return new \extend\aliyun\SmsClient(
$app->config->get('aliyun.sms.access_key_id'),
$app->config->get('aliyun.sms.access_key_secret')
);
});
获取绑定对象时，别直接 new 或静态调用，要走容器解析
绑定之后，必须用 app('aliyun.sms') 或 Container::getInstance()->get('aliyun.sms') 获取实例。直接 new \extend\aliyun\SmsClient() 会绕过容器，导致依赖无法注入、配置无法动态替换、测试无法 Mock。
尤其注意构造函数中有类型提示的类（比如依赖 Config 或 Log）：只有走 make() 或 get() 才能触发自动注入。
容易踩的坑：
- 在门面（Facade）里硬编码
new第三方类——门面本就是为解耦设计的，这么写等于白搭 - 在中间件或事件监听器里用
app()->make()却忘了提前绑定——运行时报Target class [xxx] does not exist - 绑定用了别名（如
'sms'），但获取时用了完整类名（app(\extend\aliyun\SmsClient::class)）——容器找不到映射，返回空或抛异常
复杂点在于：有些第三方 SDK 内部又依赖其他类（比如日志、缓存），这时光绑定顶层类不够，得一层层补全依赖链，或者改用闭包绑定把整个创建逻辑收口。
