thinkphp 8.0 中门面模式核心是让静态调用指向容器管理的服务实例，需通过服务提供者绑定接口与实现，并在门面中返回绑定名而非类名，配置须从容器获取，门面仅作语法糖不可用于类型注入。
ThinkPHP 8.0 封装第三方 SDK 用门面模式，核心不是“能不能写静态调用”，而是“如何让静态调用背后真正指向一个受容器管理、可配置、可替换的服务实例”。直接照搬 TP6 的 Facade 写法大概率失败，因为 TP8 彻底重构了容器契约和自动加载机制。
门面必须绑定真实服务，不能只写个壳
门面类（如 app\facade\Sms）本身不干活，它只是代理。关键步骤是：先在容器中注册好 SDK 实例（通过服务提供者），再让门面指向它。
- 服务提供者（如
app\provider\AppServiceProvider）里用$this->app->bind('sms', function ($app) { return new AliyunSmsClient(...); }); - 门面类的
getFacadeClass()返回字符串'sms'（绑定名），而不是类名——这样容器才能按绑定关系解析，避免构造失败或类型不匹配 - 别返回空值、拼错的类名，或在
getFacadeClass()里写条件判断，它只应返回一个确定的字符串
接口 + 实现类绑定，保障类型提示有效
控制器里想用 public function send(\App\Contract\SmsClient $sms) 自动注入？那必须走接口契约路线。
- 定义接口
\App\Contract\SmsClient，声明send()等方法 - 实现类
\App\Service\AliyunSmsClient实现该接口 - 在服务提供者中绑定：
$this->app->bind(\App\Contract\SmsClient::class, \App\Service\AliyunSmsClient::class); - 此时类型提示才生效；若直接提示具体实现类，容器找不到定义就会报
Class not found
SDK 初始化要解耦配置与依赖
第三方 SDK 往往需要 access_key、secret、timeout 等参数，这些不能硬编码，也不能靠全局函数获取。
- 构造实例时，从容器取配置：
$app->config->get('sms.aliyun')，而非config('sms.aliyun')（TP8 已移除该辅助函数） - 若 SDK 还依赖日志、缓存等其他服务，也在闭包内从容器取，保证构造过程可控且可测试
- 避免
new AliyunSmsClient(...)直接出现在门面或控制器里——这会破坏依赖注入，也难 mock
门面只用于调用，不参与依赖注入
这是最容易踩的坑：把门面类当类型约束传入方法参数，比如 public function index(Sms $sms)。
- 门面类不是真实服务，没有构造逻辑，PHP 会尝试实例化它并失败
- 正确做法是：注入接口（
\App\Contract\SmsClient）或具体实现类（前提是已绑定到容器） - 门面只适合写在业务逻辑里做语法糖，例如
Sms::send($phone, $code)，简洁直观，但底层仍是容器解析的实例
