Facade 是 Laravel 提供的服务定位与静态接口组合机制，通过 __callStatic 动态解析容器中绑定的实例，实现 Cache::get() 等静态调用；其核心在于 getFacadeAccessor() 返回的键必须与容器绑定键完全一致，且需正确注册 alias 和启用服务提供者。
Facade 是什么，为什么 Laravel 里它不等于“静态代理”
Facade 不是语法糖，也不是单纯的静态调用封装。它是 Laravel 提供的一套服务定位 + 静态接口的组合机制，核心作用是让开发者能用 Cache::get() 这种写法，背后却走的是容器中动态解析的 Illuminate\Contracts\Cache\Repository 实例。关键点在于：每次调用 Cache::get()，实际触发的是 Cache 门面类的 __callStatic()，再委托给容器里绑定的实例方法。
常见错误现象：Call to undefined method Illuminate\Support\Facades\Cache::xxx() —— 本质是容器没绑对 contract，或 facade 对应的 getFacadeAccessor() 返回了错误 key。
- 必须确保
config/app.php中该 facade 已在'aliases'数组注册（如'Cache' => Illuminate\Support\Facades\Cache::class） - 必须确保对应服务提供者已启用（如
CacheServiceProvider），否则容器里压根没有这个 binding - 自定义 facade 时，
getFacadeAccessor()返回的字符串必须和容器 bind 的 key 完全一致（大小写敏感）
怎么手动注册一个自定义 Facade
不是所有类都天然支持被 facade 调用。要让自己的类也能写成 MyTool::doSomething()，得走三步：定义 facade 类、绑定到容器、注册 alias。
使用场景：封装第三方 SDK、聚合多个服务逻辑、统一内部工具调用入口。
- 新建 facade 类继承
Illuminate\Support\Facades\Facade，重写getFacadeAccessor()，返回你在容器中绑定的 key（比如'my_tool'） - 在服务提供者的
register()方法里，用$this->app->singleton('my_tool', function ($app) { return new MyTool(); }); - 在
config/app.php的'aliases'加上'MyTool' => App\Facades\MyTool::class，然后运行php artisan config:clear
注意：别漏掉 config:clear，Laravel 会缓存 aliases，改了不清理就还是报 Class not found。
Facade 和直接从容器取实例的区别在哪
写 app('cache')->get('key') 和 Cache::get('key') 看似一样，但行为有差异：前者是即时获取容器里的实例，后者是每次调用都重新走一遍 __callStatic() → 容器解析 → 方法代理。性能差距微乎其微，但语义和测试友好度差别很大。
性能影响：Facade 多一层静态方法拦截，但 Laravel 已优化过，实际开销可忽略；兼容性上，Facade 在非 Laravel 环境（如纯 PHP 脚本）无法工作，因为依赖 Application 实例和容器。
- 单元测试时，Facade 可用
Cache::shouldReceive('get')...（配合 Mockery），而app('cache')得 mock 容器本身，更麻烦 - IDE 支持：好的 Facade 类加了
@mixin注解（如Cache类顶部有@mixin \Illuminate\Contracts\Cache\Repository），能提示真实方法；没注解的自定义 facade 就没自动补全 - 别在循环里高频调用同一个 Facade 方法——不是性能瓶颈，而是掩盖了设计问题：应该把实例注入构造函数，而不是反复通过 facade 查找
为什么 Cache::remember() 有时不生效
这不是 Facade 本身的 bug，而是底层 cache driver 或序列化逻辑导致的“假失效”。最典型的是用 file 或 database driver 时，缓存值里含闭包、资源句柄或未正确实现 __serialize() 的对象，反序列化失败后 fallback 到 null，看起来像“没缓存住”。
错误现象：Cache::remember('key', 3600, function () { return new DateTime(); }); 返回 null 或抛 unserialize(): Error at offset。
- 避免在 remember 回调里返回匿名函数、resource、PDO 实例等不可序列化的东西
- 用
array、string、带完整__serialize()/__unserialize()的 DTO 类更安全 - 开发期建议切到
arraydriver 测试逻辑，上线前再换redis或memcached，它们对序列化更宽容
Facade 只是通道，真正卡住你的，往往是底层 driver 的边界行为——别一出问题就怀疑 Facade 写错了。
