ThinkPHP数据库查询之Db类深度解析

た入场券 2022-12-21 14:52 719阅读 0赞

> 终于快来到框架解析的结尾了，本文将会带领大家领略框架中的模型以及视图的奥秘。

### ThinkPHP模型以及视图层深度解析 ###

*  前言
 *  一、Db操作类和其它类对应关系解刨
 *  二、Db类库场景分析
 *  三、Db类库巧妙结合连接器、查询器、sql生成器使用
 *  四、关于getLastSql的实现过程
 *  五、总结

# 前言 #

在日常开发过程中模型的使用是非常之多的，但是在开发过程只知道如何使用，并不知道内在是如何实现的，模型是不管接口还是后台都会使用到的东西。

关于视图在前后台分离的大趋势下，框架存在视图大多数还是针对于后台开发的使用。

本文也是对框架解读快到最后阶段了，接下来咔咔将带领大家一起学习关于在框架中Db类的奥秘。

下图为咔咔提供的脑图可以根据这个脑图进行阅读文章。

![数据库执行流程][20201120105135960.png]

# 一、Db操作类和其它类对应关系解刨 #

在学习模型之前一定要知道的就是DB这个类，这个类也是对数据库的操作。

在框架中存在这样一个配置文件，在这个配置文件里边会存在关于数据库配置的一系列信息。

在接下来的过程中咔咔也会简单的创建一个数据库来做演示。

![数据库配置文件][2020111617031648.png]

同样在框架的核心层存在俩个类，分别为Db类和Model类，这俩个类就是接下来的解析对象。

![框架核心层需要知道的俩个类][20201116170518634.png]

在解析Db操作类和其它类对应关系解刨之前，我们先创建一个数据库作为演示使用。

![演示数据库][20201116171039874.png]

首先先来看一下Db类的信息。

![类的注释][20201116224653458.png]

通过上图我们可以看到关于Db类的一部分信息，就是使用Db类的一些查询方法。

但是来到Db类的最后可以看到一个熟悉的方法`__callStatic`。

![调用没有声明的静态方法][20201116224830811.png]

这个方法在一直读咔咔文章的读者应该已经很是熟悉了，这个方法在门面源码解析那一节中进行过深入的了解。

对于这个方法只需要记住的是在调用没有声明的静态方法时会进行调用。

至于`call_user_func_array`这个函数的使用可以理解为，这个方法是内置函数,可以直接调用函数运行，也就是可以直接运行方法。

![门面类的源码][20201116225018680.png]

在通过刚刚的查看Db类的注释信息时可以看到Db类是使用着`Connection`这个类，也就是连接数据库类。

![连接数据库类][20201116225445968.png]

进入到这个类里边简单的看一下构造函数即可，至于是怎么一个运行顺序会在下文进行讲解。

![数据库配置数组创建Builder对象][Builder]

在框架中操作控制器有俩大场景，第一中为Db类操作，第二种就是Model操作。

其中Connection·为连接器，Query为查询器，Builder为sql生成器，exception为异常类。

知道了以上的几个信息，在接下来的理解过程中会有一定的帮助，在下一节中将会对Db类库场景分析。

# 二、Db类库场景分析 #

先从一个简单的案例进行解析，先来看一下数据库的数据。

![数据库模拟数据][20201117101757213.png]

然后来到控制器写一个简单的查询案例，在创建控制器之前先使用命令进行创建一个测试控制器。

![创建的测试控制器][20201117102005130.png]

在这个控制器进行简单的查询数据。

![使用简单的案例进行查询数据库数据][20201117102319603.png]

查询结果如下

![查询结果][20201117102353628.png]

在这个案例中，可以看到使用的是`Db::query`这种查询方式，接下来对于这种查询方式进行简单的剖析。

接着执行流程就会来到Db这个类，在这个类中可以看到关于当对象访问不存在的静态方法时，\_\_callStatic()方法会被自动调用。

这个方法在之前门面的讲解中进行了深度讲解。

![Db类中的静态调用方法][Db]

从上图可以看到当执行访问对象不存在的静态方法时会执行到`call_user_func_array调用回调函数，并把一个数组参数作为回调函数的参数`

接着代码就会执行到`static::connect()`这行代码，由于本类Db没有继承任何的类，所以对于static这个的使用就是调用本类。

如果当Db类继承了其它类那么就会有一定的区别，这个区别就是关于static关键字，给大家做的一点点冷门知识得补充，当一个类继承一个类时，在父类实用static关键字时，默认调用的子类的方法。

**切换数据库连接**

因为没有任何继承，所以会来到本类的connect这个方法。

在这个类里边首先会返回结果为数据库配置信息。

然后会从配置信息中获取到`query`这个索引，最终返回`\think\db\Query`这个字符串，这里一定要注意返回的是字符串，不是这个类的实例。

紧接着就会执行到第三步创建数据库连接对象实例，接下里将会对这一步进行解析。

![切换数据库连接][2020111710342157.png]

紧接着会来到文件`实际执行的为 new \think\db\Query`，最终会返回执行查询 返回数据集，返回数据为`返回 object(think\db\Query)`

关于这个`$this->connection`是在本类的构造函数进行设置的。

![执行查询 返回数据集][20201117183417995.png]

先简单的看一下这个构造函数，在这个构造函数中直接就设置了`connection`这个属性的值，所以在上图中可以使用。

![设置连接][20201117183628597.png]

在这里执行完成之后就会将返回的值给从一开始就解析的这个调用未声明的静态方法会进行调用。

其中`static::connect()`就是最终返回的值`static::connect() 返回 object(think\db\Query)`。

![静态方法调用][20201117183755468.png]

所以接下来代码会执行到 thinkphp/library/think/db/Query.php 的 query方法

`$sql` 就是在Db::query()中传递的sql语句，并且执行查询 返回数据集

最后这段代码会执行think\\db\\connector\\Mysql的query方法

![执行查询 返回数据集][20201119140628617.png]

接下来来到think\\db\\connector\\Mysql的query方法

在这个方法中主要做了三件事情。

*  `$this->initConnect` 初始化数据库连接
 *  `$this->PDOStatement->execute();` 执行查询
 *  `return $this->getResult($pdo, $procedure);` 返回结果集

![执行查询 返回数据集][20201119140902487.png]

**解析$this->initConnect 初始化数据库连接**

在这个方法中可以看到是进行了一次配置信息获取，首先需要明白这个配置信息是什么。

![初始化数据库连接][20201119141113916.png]

这个配置项是在配置文件database中配置的，根据注释提供的信息可以看到主要是关于主从服务器设置的。

一般情况下是不会在框架中配置主从信息的，这里就不去解析框架是如何实现数据库的主从配置了。

![数据库部署方式:0 集中式(单一服务器),1 分布式(主从服务器)][0 _1]

在这个判断中在进行了一次判断当前数据库连接的id，然后执行了连接数据库方法。

这个方法最终会返回object(PDO)\#33的一个实例信息。

![连接数据库方法][20201119141514882.png]

**`$this->PDOStatement->execute();` 执行查询**

第二件事情做的就是执行查询，接下来我们来详细说明一下这个到底是如何执行的。

![执行查询][20201119141807347.png]

在返回pdo实例时，将这个实例赋值给了`$this->PDOStatement`这个属性，所以会去PDO类中进行执行。

在这里大家需要明白一件事情就是关于execute这个方法，用于执行返回多个结果集、多个更新计数或二者组合的语句。

**第三件事情返回结果集**

直到这里就是执行的最后一步就是返回结果集。

这里使用的方法都是查询底层，就在去解析了，在这里就会返回最终查询结果。

![获得数据集数组][2020111914222449.png]

最终结果就会返回给这里`__callStatic`方法，并且返回给上层的`$res`变量。

![测试案例][20201119142417796.png]

![最终查询结果][20201119142349627.png]

直到这里关于使用Db查询的执行流程就解析完了， 但是框架给封装的方法不仅仅只有query，其它的查询方式可以按照咔咔的这个流程在进行简单的分析。

最后执行的都会是这一节的最后几个流程，只是前边执行会有一点点区别而已。

# 三、Db类库巧妙结合连接器、查询器、sql生成器使用 #

在上目录中咔咔使用了query作为案例演示，这个使用在框架中是不建议使用的，因为在维护的方面会有一定的难度。

本节案例将会使用框架常用的查询数据库方式进行查询。

![使用案例代码][20201119144523659.png]

在上图中可以看到使用了平时最常用的查询方式，接下来将会对这组案例进行详细分析。

同样代码会来到Db类的`__callStatic`这个方法，这个方法就是在调用没有声明的静态方法会进行执行的。

这个方法跟\_\_call方法是有区别的，\_\_call方法是调用不存在的方法会进行调用，一定要注意俩者的区别。

![调用未声明的静态方法会调用][20201119144625146.png]

对于上图方法中`static::connect()`执行最后会返回 `object(think\db\Query)`这个对象，至于内部流程的执行可以参考第二目录的内容。

所以执行流程会来到`thinkphp/library/think/db/Query.php`这个类的`table`方法。

参数就是table中传递的数据库表名`tp_test`。

![指定当前操作的数据表][20201119145007972.png]

按照上图提供的代码会对传递过来的表名进行三次判断。

*  第一次判断是否为字符串
 *  第二次判断是否存在 ）
 *  第三次判断是否存在 ，

根据传递过来的字符串以上三个判断均不成立，于是会执行到下面流程。

在table这个方法中可以看到最后的执行流程就是将传递过来的表名存放在属性`options`这个里边。

![最后执行流程][20201119145414942.png]

并且最后会将`think\db\Query Object`这个对象进行返回。

![返回Query对象][Query]

**where方法解析**

table方法分析完成后会紧接着执行where方法，同样还是在类`thinkphp/library/think/db/Query.php`

![指定AND查询条件][AND]

上图中在这个类中可以看到一个方法`func_get_args`，这个方法会返回一个包含函数参数列表的数组。

这个方法平时都是跟`call_user_func_array`同时使用，之前咔咔也使用这俩个方法进行过一次案例实验。

然后会使用函数`array_shift`删除数组中的第一个元素（red），并返回被删除元素的值。

下图第一个结果为`func_get_args`这个方法获取出来的数据，第二组结果为`array_shift`这个方法返回的结果。

俩组结果返回的值可以进行对比一下，可以更好的理解`array_shift`的使用场景。

![前后俩次返回结果对比][20201119150055578.png]

紧接着会进行分析查询表达式，也就是方法`parseWhereExp`做的事情。

在这个方法中需要注意一个点就是关于传递过来的这俩个参数。

参数一为查询逻辑，参数二就是在使用案例时传入的参数。

![分析查询表达式][20201119150957321.png]

在代码的第一行就需要我们来学习的一个知识点`instanceof`。

`instanceof`可以判断某个对象是否是某个类的实例，判断一个对象是否实现了某个接口。

关于这个的使用案例在文章`ThinkPHP源码解析之控制器`这一文中做了详细的说明。

根据学习`instanceof`的作用可以清晰的明白第一个判断不会进行执行。

在继续学习以下的执行流程，根据咔咔圈出来的框来进行对代码进行简单的解析。

![继续学习下半部分][20201119151634170.png]

根据上图首先会对查询逻辑的符号全部转为小写

然后在进行判断`$field instanceof Where`传递过来的参数是否为Where类的实例。

最后一个判断就是`$field instanceof Expression`跟上一步是判断同样的功能。

所以说代码最终的执行逻辑就是下图圈到的部分。

![解析数组批量查询][20201119152031900.png]

还记得在案例过程中给where传递的参数就是一个数组。

如果将参数改为`where('t_id',1)`则就会走`is_string($field)`的这个流程，这个流程就交给大家了，咔咔就不去解析。

这里咔咔还是使用数组作为参数进行解析，那么代码依然会执行本类的`parseArrayWhereItems`这个方法

![数组批量查询][20201119152326742.png]

在这个方法中先需要知道`key`会返回什么，从当前内部指针位置返回元素键名。

所以代码会去执行if语句的判断，根据上边的所有判断都不符合所以会执行这段代码`$where[] = [$key, is_array($val) ? 'IN' : '=', $val];`

这段代码会判断循环数组的value值是否为数组，如果为数组就是in，反之为=，由于value为1所以数组的第二个值为=。

那么最终where的值就是下图打印的数据。

![where最中返回的值][where]

由于where不为空，代码执行流程会执行到下图位置，最终在返回本类实例。

![将查询参数存储到option属性中][option]

**find()执行流程**

接着代码会还是执行本类的find方法，查找单条记录。

由于find中是没有传递参数的，所以代码会执行到`$this->parseOptions();`分析表达式（可用于查询或者写入操作）

就目前写的案例而言，这段看似很长的代码大家好好看看都可以看明白，最终依然是返回当前的所有参数。

![查找单条记录][2020111915445632.png]

以下就是返回的所以结果

![返回所有的参数结果][20201119155533971.png]

真正的查询数据是这块代码`$result = $this->connection->find($this);`，这段代码会执行到文件`thinkphp/library/think/db/Connection.php`

从这块代码可以看到当查询一条数据时框架默认给加上了limit为1，至于为什么这么加你就需要查看一下sql优化方面的知识了。

![查找单条记录][20201119155926353.png]

在这里就是关于sql语句的生成，代码自己好好看看就会明白，咔咔解析的只是执行流程和具体代码简单的了解一下即可。

至于具体实现流程咔咔在后期如果有机会会单独把每个方法进行深度解析，那时就是主要针对代码的解析。

![根据一定的规则生成sql语句，并且进行查询][sql]

最终返回结果如下

![返回结果][20201119160839891.png]

以上就是关于Db在结合连接器，查询器，生成器实现的数据库查询功能。

截止到这里关于Db的场景就分析到这里，接下来咔咔将会对Model进行简单的分析。

# 四、关于getLastSql的实现过程 #

还是之前的案例，我们来使用这个方法打印一下结果来看一下是什么。

![打印案例][20201119185640297.png]

看到上图就知道是框架最终给生成的SQL语句，那么接下来咔咔就会带大家一起来探讨一下，这个sql语句是如何生成的。

下图为本次演示的案例，也就是咔咔下图圈出来的地方。

![演示案例][20201119190157127.png]

从上图圈出来的地方进行代码追踪会到文件`thinkphp/library/think/Db.php`，并且会去执行本类的\_\_callStatic方法，这个方法就不在进行解释了，在上文和之前也已经提到过多次了。

并且返回结果也不去做声明了，上文也提到了，这里只需要知道最终返回结果为`返回 object(think\db\Query)`

![调用未声明的静态方法时会进行执行][20201119190712418.png]

根据上图的返回结果可以知道最终回去调用`object(think\db\Query)`这个类的`getLastSql`这个方法

根据这个方法可以知道是获取最近一次查询的sql语句。

![获取最近一次查询的sql语句][sql 1]

这里就会有点疑问了，关于属性`connection`到底是什么，这里在进行一次简单的简析。

关于这种属性的声明一般都会在本类的构造函数或者父类的构造函数中进行声明，这也是在阅读源码时的一个小窍门。

于是我们首先就需要来到本类的构造函数来看一眼。

![架构函数][20201119191432733.png]

通过上图可以得知，此处使用了依赖注入的方式，所以`Connection`就是一个对象，并且也是框架中所谓的连接器。

所以说这个`Connection`对象就是下图打印出来的。

![连接器的对象打印结果][20201119191643464.png]

根据上图得知使用的类文件应该就是`think\db\connector\Mysql`那么就会执行这个类里边的`getLastSql`方法。

但是来到这个类执行你会发现这个类里边根本是没有这个方法。

![继承关系][2020111919192158.png]

根据上图的继承关系，我们就知道这个方法是在`thinkphp/library/think/db/Connection.php`这个类文件里边。

下图即是这个方法执行过程，可以看到存在俩个参数，但是这俩个参数还是一头雾水根本不知道是什么。

![获取最近一次查询的sql语句][sql 2]

根据代码追踪我们对上图所出现的俩个参数先进行简单的说明

*  `$this->queryStr`当前SQL指令
 *  `$this->bind` 绑定参数

**追踪$this->queryStr这个属性值**

走到这里估计有点蒙了吧！对于这个值有点确定不了了，指定不是靠打印可以获取到结果的。

当然还有另一种办法就是进行debug来断点调试。

但是既然咔咔带大家看源码呢！就不会用上边的俩种方式，会直接从源码中找到蛛丝马迹。

根据咔咔上边给提供的案例，执行的最后一步就是find方法，这个方法也是在`thinkphp/library/think/db/Connection.php`这个类里边，寻找单条记录。

那么我们就在这个方法中进行一点点的寻找，这里咔咔已经给大家圈好了，就是下图咔咔圈其起来的地方。

![执行查询][20201119230250914.png]

根据上图咔咔给的代码注释，第一个参数就是生成的SQL语句，来继续追踪这个方法看一下，此时这个方法依然会在本类`thinkphp/library/think/db/Connection.php`这个文件中实现`query`方法。

在这个方法中一眼就可以看见对于这个`queryStr`属性的设置，是直接给这个属性赋值，那么也就是说这个属性的值就是上一个SQL语句生成的SQL语句。

![执行查询 返回数据集][20201119230442719.png]

所以说这个`getLastSql`获取的就是在这个语句之前执行的SQL语句，也只能获取出最近执行的那个SQL语句。

以上就是关于`getLastSql`的实现原理，在这里需要注意的就是关于SQL的生成，这块属实有点复杂。

# 五、总结 #

截止到这里关于数据库中Db类的操作场景分析以及关于结合连接器，查询器，生成器就到这里结束了。

这里咔咔主要就是使用了俩种案例来进行执行，第一种为原生案例，第二种为框架封装的案例。

使用了这俩种案例来对源码进行了深度解析，但是在文档还有很多的实现方法，其它的方法只需要根据咔咔给的提示然后一点点解析即可。

不需要对所有的方法都进行执行，不管任何方法走的都是上文分析的方法，也是很简单。

最后在演示了一下关于使用`getLastSql`来获取最后一次执行的SQL语句查询，这里的实现原理主要就是在Db类操作数据库时，不管是使用find方法还是select方法最终都会走向一个方法那就是query方法。

同样在这个方法中存在一个属性值`queryStr`，也就是在这个时候将SQL语句赋值进去的，然后在使用`getLastSql`这个方法使用`queryStr和bind`属性在对SQL进行拼接，最总返回SQL语句。

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

[20201120105135960.png]: /images/20221120/205afa9c60c64396b382b4e27feccd3f.png
[2020111617031648.png]: /images/20221120/a2e174db6f38421f91e5e1c7a6f58130.png
[20201116170518634.png]: /images/20221120/ae85599d82bc474dab4cf556c1d43a71.png
[20201116171039874.png]: /images/20221120/794ecc65b00642088d19a6ef2f57cc4f.png
[20201116224653458.png]: /images/20221120/7ac8c7d90b9747f08a696acbe53683a7.png
[20201116224830811.png]: /images/20221120/8d6b3b5506dd44ba8cb249eccf6d4629.png
[20201116225018680.png]: /images/20221120/a0b4e660fd084e559055ab0a7f2e2f62.png
[20201116225445968.png]: /images/20221120/2e6f0db3988a453f8c5339f1112b0b42.png
[Builder]: /images/20221120/3e2393937a764a89936a2fc229106d5f.png
[20201117101757213.png]: /images/20221120/2bd1307a1ca24b779b126a2ed640eff9.png
[20201117102005130.png]: /images/20221120/a3646bc224bd47948d0317a3a80054d7.png
[20201117102319603.png]: /images/20221120/3b31da6865524ad4a851ab4c93cc9735.png
[20201117102353628.png]: /images/20221120/186ed054ae964a5e81b328ee33e14b4e.png
[Db]: /images/20221120/f570c7610da941ef9cfbdea94447ce9d.png
[2020111710342157.png]: /images/20221120/8ba434957c184a6f9f36fd77ee37b634.png
[20201117183417995.png]: /images/20221120/9c886a693b2840fe95fc90e191894084.png
[20201117183628597.png]: /images/20221120/a6a105cea27d4a948991a79f83e2ef87.png
[20201117183755468.png]: /images/20221120/5857a0670a004274a62775159cc5f5b1.png
[20201119140628617.png]: /images/20221120/0d8fac150f6b4e7d9ecb42b7fc1ff054.png
[20201119140902487.png]: /images/20221120/7ef0c90da08c42459e1b7ba5698f2a15.png
[20201119141113916.png]: /images/20221120/fe56d0e34ff844eea4120afa6caf3b3e.png
[0 _1]: /images/20221120/074d64b6e8a84477b6cf26fb267b80b8.png
[20201119141514882.png]: /images/20221120/5b1fc3a36c4b444399aa88f5e6d56129.png
[20201119141807347.png]: /images/20221120/4fe2e8a87f04440eb1da6cce84bef3f5.png
[2020111914222449.png]: /images/20221120/d5d0f9be2e434abc9540e920c073f36d.png
[20201119142417796.png]: /images/20221120/ac372359f7d5410f849b5657a3878cba.png
[20201119142349627.png]: /images/20221120/324669458fbe4410834a4cc5df92032a.png
[20201119144523659.png]: /images/20221120/c629baa45f8b49419aef02f4c1524273.png
[20201119144625146.png]: /images/20221120/db66bf6f4f8a49e6b74f7fabdda78793.png
[20201119145007972.png]: /images/20221120/637fe31f71874326affe15d561ece2a0.png
[20201119145414942.png]: /images/20221120/10561123b9e04cd39601f5c25c5df430.png
[Query]: /images/20221120/cd41a6a28d06424b89a234a2d02082c3.png
[AND]: /images/20221120/9128b26a3788468884c2d63ff0c4e508.png
[20201119150055578.png]: /images/20221120/8dd91e6d6e0a4885be24d59cc1e97036.png
[20201119150957321.png]: /images/20221120/c425ddd2655a489985d49fedc3922e34.png
[20201119151634170.png]: /images/20221120/1ee48a7393db4df8ac2b0e963e225c0f.png
[20201119152031900.png]: /images/20221120/46f4821380494e84b02955178512942d.png
[20201119152326742.png]: /images/20221120/eb7ef2b272aa471e9929290b51fe8841.png
[where]: /images/20221120/df05882e3538472790d3ad7e46ddfc8e.png
[option]: /images/20221120/b56adbc73f0b4b76b753eed4682f0a71.png
[2020111915445632.png]: /images/20221120/79db54d0a0c84fc39b5d453318cf24bb.png
[20201119155533971.png]: /images/20221120/07e3d1a5b9d040fd98b463ac53a80376.png
[20201119155926353.png]: /images/20221120/3cede033b0c7495a90dfd4d9a593ea6a.png
[sql]: /images/20221120/a453e1f867df4698b1505edd10d55cfa.png
[20201119160839891.png]: /images/20221120/b2f326015ce44e52a8ffe3136d1b107c.png
[20201119185640297.png]: /images/20221120/58137e2142dc470195b80a751767eb08.png
[20201119190157127.png]: /images/20221120/b607725a50d54ed9aff4b792a099a57d.png
[20201119190712418.png]: /images/20221120/73b02ab085a94134ab359af94e112f6e.png
[sql 1]: /images/20221120/428c57ee21bd49a8977c722648f25d23.png
[20201119191432733.png]: /images/20221120/b24755ea034544c19bf27a7d98939d79.png
[20201119191643464.png]: /images/20221120/05bb918118654349ab08400db489fda6.png
[2020111919192158.png]: /images/20221120/3178c123b1ca4a5898b94c22d153516f.png
[sql 2]: /images/20221120/32236c3f735b4f85887a6fe47655d557.png
[20201119230250914.png]: /images/20221120/c89aba5ebd13467b8d1f4e5f0ac308ff.png
[20201119230442719.png]: /images/20221120/939fd50c5c9a4600ad5e46f1b62dfa1e.png