Laravel的Facade门面模式是对服务容器中底层类的静态代理，它提供了一种简洁的语法来调用容器中的实例方法，不需要手动解析依赖或者记忆长的类名。创建自定义Facade可以让我们的业务类也拥有这种便捷的调用方式，下面是实现自定义Facade的完整步骤。
Facade的工作原理
Facade的核心逻辑是通过__callStatic魔术方法，将静态调用转发到服务容器中解析出的对应实例方法。每个Facade类都需要实现getFacadeAccessor方法，该方法返回服务容器中绑定的服务标识，Facade会根据这个标识从容器中解析出对应的实例，再调用对应的方法。
创建自定义Facade的步骤
第一步：定义业务服务类
首先我们需要有一个要被Facade代理的业务类，比如我们创建一个处理字符串格式化的服务类：
<?php
namespace AppServices;
class StringFormatter
{
/**
* 将字符串转为大写并添加前缀
* @param string $str
* @param string $prefix
* @return string
*/
public function formatWithPrefix(string $str, string $prefix = 'pre_'): string
{
return $prefix . strtoupper($str);
}
/**
* 去除字符串中的特殊字符
* @param string $str
* @return string
*/
public function removeSpecialChar(string $str): string
{
return preg_replace('/[^ws]/u', '', $str);
}
}
第二步：创建服务提供者并注册服务
要让服务容器能够解析我们的StringFormatter类，需要创建一个服务提供者来绑定服务：
<?php
namespace AppProviders;
use AppServicesStringFormatter;
use IlluminateSupportServiceProvider;
class StringFormatterServiceProvider extends ServiceProvider
{
public function register()
{
// 绑定服务到容器，使用单例模式避免重复实例化
$this->app->singleton('string_formatter', function ($app) {
return new StringFormatter();
});
}
public function boot()
{
//
}
}
之后需要在config/app.php的providers数组中注册这个服务提供者：
'providers' => [
// 其他已有服务提供者
AppProvidersStringFormatterServiceProvider::class,
],
第三步：创建自定义Facade类
接下来创建继承IlluminateSupportFacadesFacade的自定义Facade类，实现getFacadeAccessor方法返回我们之前绑定的服务标识：
<?php
namespace AppFacades;
use IlluminateSupportFacadesFacade;
class StringFormatterFacade extends Facade
{
/**
* 获取在容器中绑定的服务标识
* @return string
*/
protected static function getFacadeAccessor()
{
return 'string_formatter';
}
}
第四步：使用自定义Facade
现在就可以在代码中通过Facade的静态方法调用StringFormatter的实例方法了：
<?php
namespace AppHttpControllers;
use AppFacadesStringFormatterFacade;
use IlluminateHttpRequest;
class TestController extends Controller
{
public function testFacade(Request $request)
{
$input = $request->input('content', 'test content');
// 静态调用formatWithPrefix方法
$result1 = StringFormatterFacade::formatWithPrefix($input, 'custom_');
// 静态调用removeSpecialChar方法
$result2 = StringFormatterFacade::removeSpecialChar('hello@world!');
return [
'result1' => $result1,
'result2' => $result2
];
}
}
Facade的别名配置（可选）
如果觉得Facade的完整类名太长，可以在config/app.php的aliases数组中配置别名，之后可以直接使用别名调用：
'aliases' => [
// 其他已有别名
'StringFormatter' => AppFacadesStringFormatterFacade::class,
],
配置别名后，调用可以简化为：
// 不需要use完整命名空间，直接使用别名
$result = StringFormatter::formatWithPrefix('test');
常见问题说明
- 如果调用Facade时出现服务未找到的错误，首先检查服务提供者是否已经注册，其次检查
getFacadeAccessor返回的服务标识是否和容器中绑定的标识一致。 - Facade只是静态代理，不会修改底层类的逻辑，底层类的所有公共方法都可以通过Facade的静态方式调用。
- 不建议过度使用Facade，对于简单的业务逻辑，直接依赖注入或者手动实例化类可能更清晰，Facade更适合封装常用的、全局性的服务。
注意：Facade的getFacadeAccessor方法返回的不一定是字符串，也可以返回类的全限定名，Laravel会自动从容器中解析该类的实例，前提是该类已经在容器中绑定或者可以被容器自动解析。