Laravel 中的 facades 是什么？

Question

Accepted Answer

**Facades** 为服务容器中的类提供了一个简洁的、类似静态方法的接口——例如 `Cache::get()`、`DB::table()`、`Route::get()`。它们看起来像静态方法调用，但实际上**代理到从容器中解析的底层对象**，结合了静态语法的便利性和依赖注入的可测试性。

## Facades 看起来是静态的，但实际上不是

```php
use Illuminate\Support\Facades\Cache;

Cache::put('key', 'value', 60);     // looks like a static call...
Cache::get('key');

// ...but under the hood it proxies to a container-resolved cache instance.
// Equivalent to: app('cache')->put('key', 'value', 60);
```

Facade 不是真正的静态类——它将调用转发给从服务容器中解析的实际对象。因此你既获得了简洁、便捷的语法，又由于底层的对象是可注入、可模拟的服务，所以实际工作也是可测试的。

## 常见的 facades

```php
DB::table('users')->get();           // database
Cache::remember('stats', 60, fn() => compute());   // caching
Auth::user();                         // authentication
Route::get('/', ...);                 // routing
Log::info('message');                 // logging
Storage::put('file.txt', $content);   // filesystem
Mail::to($user)->send(new Welcome()); // mail
Validator::make($data, $rules);       // validation
```

Facades 为 Laravel 的服务提供了易于记忆、富有表现力的 API——这是框架「优雅语法」的一部分。

## Facades 是可测试的（不同于真正的静态方法）

```php
// you can MOCK a facade in tests (impossible with true static methods)
Cache::shouldReceive('get')->with('key')->andReturn('value');
Mail::fake();                          // assert mail was sent without sending it
Mail::assertSent(WelcomeEmail::class);
```

由于 facades 代理到容器对象，Laravel 可以在测试时注入模拟对象——`Cache::shouldReceive(...)`、`Mail::fake()`——而真正的静态方法则无法做到这一点。

## Facades 与依赖注入的对比

```text
Facade → convenient static-like syntax (Cache::get()), great for quick access
DI (constructor injection) → explicit dependencies, clearer for testing/coupling
→ Both resolve from the container; facades are sugar. Use DI when you want explicit
  dependencies; facades for concise access. (Some prefer DI for clarity.)
```

## 为什么这很重要

Facades 是 Laravel 的一个独特而普遍存在的特性——它们遍布 Laravel 代码中（`DB::`、`Cache::`、`Auth::`、`Route::` 等），因此理解它们对于阅读和编写 Laravel 应用程序至关重要。

关键的洞察是 facades **看起来像静态调用，但实际上代理到从服务容器中解析的对象**——这为你提供了方便、富有表现力的类似静态的语法，这是 Laravel 吸引力的一部分，同时在底层保留了依赖注入的优势（实际工作由可注入、可模拟的服务完成）。

至关重要的是，这意味着 facades **尽管看起来像静态的，但仍然是可测试的**：Laravel 可以注入模拟对象（`Cache::shouldReceive()`、`Mail::fake()`）——这对真正的静态方法是不可能的，而真正的静态方法众所周知很难测试。

理解 facades 如何工作（容器代理）、常见的 facades、它们的可测试性，以及与显式依赖注入的**权衡**（facades 用于简洁的访问 vs 构造函数注入用于显式、清晰的依赖——两者都有效，都从同一个容器中解析）是有效使用 Laravel 的重要知识。

由于 facades 是 Laravel 最具辨识度的特性之一，而且被频繁使用，揭示它们的神秘面纱（它们不是神奇的静态方法，而是容器代理）并知道何时使用它们而不是依赖注入，这反映了对框架设计的深刻理解，并帮助你编写干净、可测试的 Laravel 代码。