插件窝 干货文章 ThinkPHP门面源码解析

ThinkPHP门面源码解析

padding margin bottom 编辑器 197    来源:    2024-10-27

本文主要描述了门面的使用和实现过程,并且对源码进行剖析。

前言

使用框架的伙伴应该都知道在5.1时框架新增了一个特性那就是本文将编写的门面,也就是facade这个特性。

使用过这个特性的都明白其中的好处,那就是方法调用可以直接静态进行调用,不用再使用关键字static来定义。

接下来咔咔将会从以下几个方面带着大家探索属于门面的故事。

一、简单认识一下在框架中的门面的好处

在之前有写过配置文件加载一文,在那一文中的最后提到过配置信息获取的几种方式。

其中有一种方式就是Config::get(),到这篇文章应该都知道使用Config获取配置信息时,必须先得引入use think\facade\Config,又因为在系统中注册了别名,所以直接使用use Config即可。

虽说我们使用的是use think\facade\Config,但是实际调用的方法却是thinkphp/library/think/Facade.php中的__callStatic方法。

然后会执行同文件的createFacade方法。

虽说现在还没有看源码,看着知道就好了,在调用createFacade方法时是直接从容器类里边获取的。

在学习容器时我们都知道容器是使用了注册树模式,需要使用对应对象实例的时候就可以直接获取,这样就避免了一个类反复的创建。这就是其中的一个优点。利用容器的特性

对于以前使用config来说,需要使用config的命名空间,然后进行实例化才能进行调用。

如果此时config不让使用了,需要使用自己创建的config类,如果没有使用门面模式,就需要修改大量的代码,而且是全局的。

但是如果使用了框架中的facade门面模式之后,你就只需要重写getFacadeClass这个方法即可,只需要改变里边的返回结果诶自己定义的即可,因为对于其它文件调用的地方它们不关心实例调用的是什么,只关心方法名和返回结果。

二、学习框架中facade的使用

首先创建一个控制器Facade,并且写上以下内容。

这里只是简单的使用门面的方式来获取配置文件信息。

在这里可以看到使用的是use Config,这个就是config类的别名。

别名的设置是在base.php中设置的。

a186e553e85631df6a54f657a9d8323.png在框架中如何正确的使用facade呢!

在app目录下新建一个文件夹facade,用来专门存放门面类。

这里创建了一个Sessions的类。

9793ba04cff923605063580b46c4e60.png先做一个测试,检测代码是否写的有问题。在控制器的facade文件中进行测试。

这就是没有使用门面时的处理方式,需要引入对应的类,然后进行实例化,在用实例化的类进行方法调用。

685628cf92642acd898d4556c0d4488.png打印结果,结果就是我们预期的结果。

5d2e3ffdc84ce316a9049a5ea7a08da.png那么这份代码怎么改为门面模式呢!跟着咔咔的脚步一步一步的来。

先在kaka目录下建立俩个目录,分别为facade和util

4a8504e75325febe2cec2924df9e585.png为什么要建立这俩个文件夹呢!util大家应该都知道那就是工具类,这种类文件是可以在其它项目中公用的。

也就是说我们只需要实现一份然后在其它项目中用的时候直接拿过去就可以了。

所以就可以直接把文件复制到util目录下,记得修改命名空间即可。

03f8a701cc42820cb21374b81bcb0c7.png然后在到facade目录下新建一个Sessions的类,并且继承Facade。然后写上一下内容。

7aa4adf8ef28f3aee28b44f9cfb377b.png此时我们在来到控制器进行测试一下。

会发现结果跟之前是一致的,但是很明显的一个区别就是使用了facade模式后,可以直接使用静态方式进行调用。

还记得在之前说过门面的一个好处吗?

假设这个Sessions工具类在未来的一天停止使用了,那么我们只需要修改getFacadeClass方法里边的内容即可。

d833939b5714faf32f0ef9e9cdc5dd1.png门面打印结果

三、优化在框架中facade的使用

在上文中我们从实例化类到使用门面方式实现了同一个功能。

虽说想要实现的效果显示出来了,但是代码还是不够简洁优美的,结构也比较混乱。

接下来咔咔会给大家提供一个可行的方案,如果你有其它的方案可以提出来哈!评论区见。

在正常开发工作中自定义的门面类不可能只有一个或者几个,在复杂的项目中门面类会有很多。

既然多,那就需要进行管理。

4bee76760c92f8229e6562685dcf682.png首先建立一个属于门面的配置类。

并将代理类和实际类对应起来,然后设置别名。

095ce4eda5cca47fc9b566540554c7f.png此时需要建立一个钩子文件,将门面类注册和门面类别名注册都放在里边进行执行。

6ad79588f7db3fcb8069d4918e17a62.png还有最后一步,那就是钩子文件虽然创建了但是没有执行。

那么钩子文件应该什么时候执行呢!那就是在应用初始化的时候进行加载。

在TP5.1中应用初始化的配置是在application/tags.php这个文件中。

在应用初始化的配置项里把钩子文件配置进去即可。

174e74885b8a8df57d4918cc7f8d5b4.png测试

最后一步就是测试了,依然是执行application/index/controller/Facade.php文件中的getUserInfo方法。

根据测试结果可以得知我们的方案代码编写没有问题。

b1a814b9e35c05eafefbf34f58d9c9d.png63d2842b997e35de8c964d880e6d48f.png这里有没有发现一个问题,就是既然在钩子中定义了门面类的别名了,但是在这里并没有使用。

接下来我们使用别名来测试一下。

a4e5fbc721d4203abb6e2e9e66d60e8.pngc4f84efccded1f2f0410851ae6d8bf5.png

四、门面类源码解析

在解析源码之前先认识俩个方法。

  • __callStatic:当访问不存在的静态方法时,会调用此方法。
  • call_user_func_array:可以直接用此函数来直接调用函数。

我们就从获取配置文件开始解析

cd934e04d7ffa37c6e187806e27c552.png执行Config::get('facade.');会执行到文件thinkphp/library/think/facade/Config.php中。

在这个文件中就是之前说的,如果存在getFacadeClass方法就会直接返回对应的别名。

如果不存在的话就需要使用bind方法来进行门面绑定。

这里如果不明白就需要去文档好好看看门面那一章节哈!

d4e60301a491eeb26cc4adc5728ad83.png在上边类中是不存在get方法的,所以就会直接调用thinkphp/library/think/Facade.php文件中的__callStatic方法。

这个方法就是文章开头就直接说明的,访问不存在的静态的方法时则会调用此方法。

717205f6c941dd10898dd657ddf9db0.png接着就会执行本类中的createFacade这个方法

在这个方法里边有一行代码是这个样子的$facadeClass = static::getFacadeClass();这段代码会在下文做详细的说明。

因为在子类中也有同样的方法,在本类中也有同样的方法但是在本类中的方法是没有任何返回值的。

这时你有没有一丝丝的困惑,这里使用的static到底会执行哪里的方法。或者这样想,为什么会执行子类的方法。

保留这些疑问将会在下文给你细细的讲来,先来把门面类的源码看完。

在这个方法中主要看我圈起来的几个地方。

第一处就是从子类的getFacadeClass方法获取类的别名。

第二处是当子类没有getFacadeClass方法时,从手动绑定的属性中获取。

第三处就是之前文章提到的容器了,这里就不对这里做详细说明了,如果不会的点开主页去看之前的文章。

90594f0bb39e5a45e5fdc1a40f3e2ab.png
createFacade方法

五、static关键字

在这里不得不说明一下static这个关键字。

新学习的伙伴估计只能知道static是用来定义静态变量和静态方法的。

当然这里不会去给大家说怎么定义静态方法和静态变量,而是说一个非常非常小的细节点。

先看一个实例,这个实例也是在阅读门面源码时,咔咔根据门面源码改编过来的。

咔咔这里新建了俩个文件,分别为test和test1。

test继承test1文件,并且都有同样的方法getKaka。

a06de1a0da19e3fc05bed80a05d9641.png
新建俩个文件

test的源码

472c01e4c2e668c3181358d83919455.png
test源码

test1源码

3baac38edda608f1a87bcad4905c9b5.png控制器进行调用

75e3d3d3d8a2f19a63ff83793f8b009.png打印结果233ef1f16ad776f86f34823c3f596d6.png这个时候有没有一点点疑惑,这里怎么打印出来的是147,而不是456呢!

修改test1的代码,把static改为self

e1502a13c1441afea03633e6d61df67.png打印结果

c8a865f6f5c5ebc697587ec407db8a9.png使用self的代码相信大家都看的明白,那为什么使用static就出现了有可能不太明白的结果呢!

此时就是文档开始起作用了,但是当你打开PHP文档会发现,在static这一篇中并没有对这类情况作出说明。

经过咔咔多次测试和查阅资料,最终总结结果如下。

static::$test  如果有被继承的话 默认调用子类 ,否则调用的是自身

self::$test    如果有被继承的话,默认调用本类

放在本实例中来说明就是,当test继承test1时。

在test1中使用static调用方法getKaka时,默认调用的是test类中的getKaka,也就是子类的方法。

在test1中使用self调用方法getKaka时,默认调用的是test1类中的getKaka,也就是本类的方法。

这个小小的细节也是咔咔无意中发现的,如果有什么不对的地方可以提出来,咔咔作出修改。

因为在继承这方面还有另外一种情况,咔咔私下会进行测试,在这里就不说明了。

这里对这个static做出解释主要是为了解释thinkphp/library/think/Facade.php文件中这个行代码。

因为这行代码调用的方法在子类和父类都存在,所以咔咔为了不让大家出现迷惑就写出来做一个简单的介绍。

f75e2e65a8487c78b5e0d5dbda479e8.png
thinkphp/library/think/Facade.php

六、总结

先来一份门面流程图,可以更清晰的看到门面类的具体执行流程。

aadad09de4920b35efee7bdf25d9b94.png门面类的源码很是简单,除了几个不太常见的知识点,代码相信都看的明白。

这里主要是对阅读完门面类后,做一个小总结。

门面类主要是结合了容器来实现的一个功能,因为需要容器来返回对应的实例,关于容器的文章也已经完成了,如果对容器有不会的可以在文章的开头去看对应的文章即可。

本文中给大家介绍了门面在容器中如何使用,并且给大家提供了最优的使用方式,这里的最优是咔咔个人见解,因为这种方式咔咔使用了接近俩年了。

无论从代码的健壮性还是扩展性都是非常实用的。

再就是关于static关键字,给大家做的一点点冷门知识得补充,当一个类继承一个类时,在父类实用static关键字时,默认调用的子类的方法。

这里的总结只是针对于本文的实例。

其实在这里咔咔还想给大家说明一个点就是return call_user_func_array([static::createFacade(), $method], $params);

因为在以前的用法的哥参数就直接是方法,但是在这里碰到了数组形式,那么这个数组中的俩个值都代表的是什么呢!

第一个值为实例,第二个值为实例中的方法。

关于call_user_func_array这个方法的使用咔咔就不去做案例给大家看了,只需要知道它会去执行传入得方法即可。

到这里关于门面的源码解析就结束了,最重要的还是理解容器,因为门面就是在容器的基础上实现的,这也就是咔咔先写容器在写门面的原因。

还有就是关于门面的使用咔咔也给出了方案,如你有更好的方案可以在评论区给一个大概的思路。

坚持学习、坚持写博、坚持分享是咔咔从业以来一直所秉持的信念。希望在偌大互联网中咔咔的文章能带给你一丝丝帮助。我是咔咔,下期见。

            前言一、简单认识一下在框架中的门面的好处二、学习框架中facade的使用三、优化在框架中facade的使用四、门面类源码解析五、static关键字六、总结