Laravel 创建自定义 Facade 分三步：1. 定义服务类（如 LogFormatter）封装逻辑；2. 在 AppServiceProvider 中注册为容器单例并可选设置别名；3. 创建继承 Facade 的门面类，实现 getFacadeAccessor() 返回对应绑定键，并在 config/app.php 中配置 aliases 以支持静态调用。
在 Laravel 中创建自定义 Facade，核心是三步：定义一个服务类、注册为容器绑定、创建继承 Facade 的门面类并指定 getFacadeAccessor()。下面按实际开发顺序一步步说明。
1. 创建服务类（Service Class）
这是你要通过 Facade 访问的实际逻辑类。比如我们想封装一个简单的日志格式化工具：
app/Services/LogFormatter.php
内容如下：
<?php
namespace App\Services;
class LogFormatter
{
public function format(string $message, string $level = 'info'): string
{
$timestamp = now()->format('Y-m-d H:i:s');
return "[$timestamp][$level] $message";
}
public function error(string $message): string
{
return $this->format($message, 'error');
}
}
2. 注册服务到服务容器（绑定）
让 Laravel 知道如何解析这个类。推荐在 AppServiceProvider 的 register() 方法中绑定：
// app/Providers/AppServiceProvider.php
use App\Services\LogFormatter;
// ...
public function register()
{
$this->app->singleton(LogFormatter::class, function ($app) {
return new LogFormatter();
});
// 可选：同时绑定一个易记的字符串键（方便 Facade 使用）
$this->app->alias(LogFormatter::class, 'log-formatter');
}
注意：singleton() 表示单例，多数场景适用；如需每次新建实例，用 bind()。
3. 创建自定义 Facade 类
新建文件：
app/Facades/LogFormatter.php
内容如下：
<?php
namespace App\Facades;
use Illuminate\Support\Facades\Facade;
class LogFormatter extends Facade
{
protected static function getFacadeAccessor()
{
return \App\Services\LogFormatter::class;
// 或者返回上面 alias 的字符串：'log-formatter'
}
}
✅ 关键点：
- 必须继承
Illuminate\Support\Facades\Facade -
getFacadeAccessor()返回值必须与容器中注册的键完全一致（类名或字符串别名） - 类名（如
LogFormatter）将作为静态调用的名称
4. 在配置中注册门面（可选但推荐）
为了让 IDE 和 PHPStorm 正确识别静态方法提示，建议在 config/app.php 的 'aliases' 数组里添加：
'LogFormatter' => App\Facades\LogFormatter::class,
然后运行：
php artisan config:clear
这样你就能在任何地方直接用了：
use LogFormatter;
// 静态调用，等价于 app(LogFormatter::class)->format(...)
echo LogFormatter::format('User logged in');
// 输出：[2024-06-15 10:30:45][info] User logged in
echo LogFormatter::error('Something went wrong');
// 输出：[2024-06-15 10:30:45][error] Something went wrong
基本上就这些。不需要写 ServiceProvider 注册 Facade，Laravel 的 Facade 基类会自动处理代理逻辑——只要容器能解析出对应实例，静态方法就会转发过去。
