Facades(读音:/fəˈsäd/ )为应用程序的
服务容器
中可用的类提供了一个「静态」接口。你不必use
一大串的命名空间,也不用实例化对象,就能访问对象的具体方法。
use Config;
class Test
{
public function index()
{
return Config::get('app.name');
}
}
Facade 的启动与注册
Facade 的启动引导是在 Illuminate\Foundation\Bootstrap\RegisterFacades
中注册的。
public function bootstrap(Application $app)
{
Facade::clearResolvedInstances();
Facade::setFacadeApplication($app);
AliasLoader::getInstance(array_merge(
$app->make('config')->get('app.aliases', []),
$app->make(PackageManifest::class)->aliases()
))->register();
}
默认的别名配置是从
app
配置文件下的aliases
读取的,PackageManifest
是laravel 5.5
新增的包自动发现
规则,这里我们暂时不考虑PackageManifest
包提供的别名。
其中,array_merge
返回如下格式的数组:
"App" => "Illuminate\Support\Facades\App"
"Artisan" => "Illuminate\Support\Facades\Artisan"
"Auth" => "Illuminate\Support\Facades\Auth"
"Blade" => "Illuminate\Support\Facades\Blade"
...
上面代码将通过 AliasLoader
把所有的 facade
注册进自动加载。其核心就是 php
的 spl_autoload_register
。
/**
* Prepend the load method to the auto-loader stack.
*
* @return void
*/
protected function register()
{
if (! $this->registered) {
spl_autoload_register([$this, 'load'], true, true);
$this->registered = true;
}
}
注册完成后,后续所有 use
的类都将通过 load
函数来完成类的自动加载。
注意,这里在定义
spl_autoload_register
时,最后面的参数传的是true
。当该参数是true
时,spl_autoload_register()
会添加函数到队列之首,而不是队列尾部。(优先通过该函数来完成自动加载)
也就是说,
<?php
use Config;
use App\User;
class Test
{
public function index()
{
Config::get('app.name');
new User();
}
}
不管我们 use
的是具体存在的类(App\User
)还是别名 (Config)
,都将最先通过 load
函数来完成自动加载,当该函数返回 false
时,再由其他自动加载函数来完成自动加载(如 composer psr-4
)。
在 AliasLoader
的 load
方法中,主要是用了 class_alias
函数来实现的别名自动加载。
public function load($alias)
{
if (isset($this->aliases[$alias])) {
return class_alias($this->aliases[$alias], $alias);
}
}
关于 class_alias
这里帖一个官方的列子:
class foo { }
class_alias('foo', 'bar');
$a = new foo;
$b = new bar;
// the objects are the same
var_dump($a == $b, $a === $b); //true
var_dump($a instanceof $b); //false
// the classes are the same
var_dump($a instanceof foo); //true
var_dump($a instanceof bar); //true
var_dump($b instanceof foo); //true
var_dump($b instanceof bar); //true
Facade 的加载
当我们在使用 Facade
时,如:
<?php
use Config;
class Test
{
public function index()
{
Config::get('app.name');
}
}
实际上加载的是 Illuminate\Support\Facades\Config
类(因为我们已经注册了 class_alias
),相当于:
<?php
use Illuminate\Support\Facades\Config;
class Test
{
public function index()
{
Config::get('app.name');
}
}
而所有的 Facade
都继承自 Illuminate\Support\Facades\Facade
类,在该基类中定义了一个 __callStatic
方法,已至于我们能够轻松地使用 Facade
(不用实列化)。
<?php
public static function __callStatic($method, $args)
{
$instance = static::getFacadeRoot();
if (! $instance) {
throw new RuntimeException('A facade root has not been set.');
}
return $instance->$method(...$args);
}
getFacadeRoot
方法用于获取别名类的具体实列,我们知道,所有的 Facade
类都需要定义一个 getFacadeAccessor
方法。该方法可能的返回值有:
- String 类型的字符串(如
config
,db
) - String 类型的类字符串 (如
App\Service\SomeService
) - Object 具体的实列化对象
- Closure 闭包
如 Config Facade
的 getFacadeAccessor
方法如下:
protected static function getFacadeAccessor()
{
return 'config';
}
getFacadeRoot
方法将根据 getFacadeAccessor()
的返回值,从容器从取出对应的实列对象。
public static function getFacadeRoot()
{
$name = static::getFacadeAccessor();
if (is_object($name)) {
return $name;
}
if (isset(static::$resolvedInstance[$name])) {
return static::$resolvedInstance[$name];
}
return static::$resolvedInstance[$name] = static::$app[$name];
}
由于 APP 容器中已经注册过 config
的实列
<?php
//Illuminate\Foundation\Bootstrap/LoadConfiguration
$app->instance('config', $config = new Repository($items));
所以 \Config::get('app.name', 'dafault)
实际访问的是 Repository
实列的 get('app.name', 'default')
方法。
参考文献: