目录搜索
基础安装ThinkPHP5.1开发规范目录结构配置基础架构路由控制器请求架构总览入口文件URL访问模块设计命名空间容器和依赖注入Facade钩子和行为路由定义变量规则路由地址闭包支持路由参数跨域请求注解路由路由分组MISS路由资源路由快捷路由路由别名路由绑定域名路由URL生成控制器定义前置操作跳转和重定向空操作和空控制器分层控制器资源控制器请求对象输入变量请求类型HTTP头信息伪静态参数绑定请求缓存响应响应输出响应参数重定向数据库模型视图连接数据库查询数据添加数据更新数据删除数据查询表达式链式操作wheretablealiasfieldstrictlimitpageordergrouphavingjoinuniondistinctlockcachecommentfetchSqlforcepartitionfailExceptionsequence聚合查询时间查询高级查询视图查询JSON字段子查询原生查询查询事件事务操作监听SQL存储过程数据集分布式数据库定义新增更新删除查询JSON数据字段获取器修改器自动时间戳只读字段软删除类型转换数据完成查询范围模型输出事件关联一对一关联一对多关联远程一对多多对多关联多态关联关联预载入关联统计关联输出视图渲染视图赋值视图过滤模板引擎模板变量输出使用函数运算符原样输出模板注释模板布局模板继承包含文件输出替换标签库内置标签循环标签比较标签条件判断资源文件加载标签嵌套原生PHP定义标签错误和日志异常处理日志处理调试验证杂项命令行扩展库安全和性能附录调试模式性能调试SQL调试变量调试远程调试验证器验证规则错误信息验证场景路由验证内置规则独立验证静态调用表单令牌缓存SessionCookie多语言分页上传自动生成目录结构创建类库文件生成类库映射文件清除缓存文件生成配置缓存文件生成数据表字段缓存生成路由映射缓存自定义指令验证码图像处理Time数据库迁移工具WorkermanMongoDb单元测试安全建议优化建议助手函数升级指导更新日志
文字

门面(Facade)

门面为容器中的类提供了一个静态调用接口,相比于传统的静态方法调用, 带来了更好的可测试性和扩展性,你可以为任何的非静态类库定义一个facade类。

系统已经为大部分核心类库定义了Facade,所以你可以通过Facade来访问这些系统类,当然也可以为你的应用类库添加静态代理。

下面是一个示例,假如我们定义了一个app\common\Test类,里面有一个hello动态方法。

<?php
namespace app\common;

class Test
{
    public function hello($name)
    {
        return 'hello,' . $name;
    }
}

调用hello方法的代码应该类似于:

$test = new \app\common\Test;
echo $test->hello('thinkphp'); // 输出 hello,thinkphp

接下来,我们给这个类定义一个静态代理类app\facade\Test(这个类名不一定要和Test类一致,但通常为了便于管理,建议保持名称统一)。

<?php
namespace app\facade;

use think\Facade;

class Test extends Facade
{
    protected static function getFacadeClass()
    {
    	return 'app\common\Test';
    }
}

只要这个类库继承think\Facade,就可以使用静态方式调用动态类app\common\Test的动态方法,例如上面的代码就可以改成:

// 无需进行实例化 直接以静态方法方式调用hello
echo \app\facade\Test::hello('thinkphp');

结果也会输出 hello,thinkphp。

说的直白一点,Facade功能可以让类无需实例化而直接进行静态方式调用。

如果没有通过getFacadeClass方法显式指定要静态代理的类,可以在调用的时候进行动态绑定:

<?php
namespace app\facade;

use think\Facade;

class Test extends Facade
{
}
use app\facade\Test;
use think\Facade;

Facade::bind('app\facade\Test', 'app\common\Test');
echo Test::hello('thinkphp');

bind方法支持批量绑定,因此你可以在应用的公共函数文件中统一进行绑定操作,例如:

Facade::bind([
	'app\facade\Test' => 'app\common\Test',
    'app\facade\Info' => 'app\common\Info',
]);

核心Facade类库

系统给内置的常用类库定义了Facade类库,包括:

5ZL_44AX5@J2IT[NEB~~P_V.png

所以你无需进行实例化就可以很方便的进行方法调用,例如:

use think\facade\Cache;

Cache::set('name','value');
echo Cache::get('name');

think\Db类的实现本来就类似于Facade机制,所以不需要再进行静态代理就可以使用静态方法调用(确切的说Db类是没有方法的,都是调用的Query类的方法)。

在进行依赖注入的时候,请不要使用Facade类作为类型约束,而是建议使用原来的动态类,下面是错误的用法:

<?php
namespace app\index\controller;

use think\facade\App;

class Index
{
    public function index(App $app)
    {
    }
}

应当使用下面的方式:

<?php
namespace app\index\controller;

use think\App;

class Index
{
    public function index(App $app)
    {
    }
}

为了更加方便的使用系统类库,系统还给这些常用的核心类库的Facade类注册了类库别名,当进行静态调用的时候可以直接使用简化的别名进行调用。

)]HDCI5X7W$A_RW)XAG0A{U.png

因此前面的代码可以改成:

\Cache::set('name','value');
echo \Cache::get('name');

Facade类定义了一个实例化的instance方法,如果你的类也有定义的话将会失效。


上一篇:下一篇: