dbfunction.php,db助手函数 - ThinkPHP5数据库实例详解 - php中文网手册

db助手函数的使用

1、功能：选择当前操作的数据表实例(与name方法类似)

2、源码位置：/thinkphp/Helper.php

注意：这是函数，不是方法，没有定义在某个类文件中

if (!function_exists('db')) {

/**

* 实例化数据库类

* @param string $name 操作的数据表名称(不含前缀)

* @param array|string $config 数据库配置参数

* @param bool $force 是否强制重新连接

* @return \think\db\Query

*/

function db($name = '', $config = [], $force = true)

{

return Db::connect($config, $force)->name($name);

}

}

源码分析：db助手函数内部仍是通过 name方法来实现的；

3、参数与返回值：

阅读源码发现：

参数是不含前缀的表名、连接配置参数及其它；

因为数据库连接配置，通常事先配置好，所以只传表名即可；

返回的是查询类Query的对象自身，便于后面链式调用。

4、适用环境：

如果事先没有配置数据库连接信息，必须传入第二个参数；

第三个参数：是否强制重新连接也必须传值：true;

5、调用语法(以：tp5_staff表为例)：

助手函数helper.php，框架启动自动加载，所以可以直接直接使用助手函数db

db助手函数：db('staff');

6、实例演示：

tp5_staff表中数据如下：

实例：(省略前缀的表名)选择tp5_staff表，查询id等于1003的数据：

Index.php 控制器源文件：

namespace app\index\controller;

class Index {

public function index(){

//使用db助手函数选择表，并输出查询结果

dump(db('staff')->find('1003'));

}

}

运行结果：

array(7) {

["id"] => int(1003)

["name"] => string(6) "杨过"

["sex"] => int(0)

["age"] => int(35)

["salary"] => float(5303)

["dept"] => string(9) "市场部"

["hiredate"] => string(10) "2014-09-22"

}

7、局限性或注意事项：

db()助手函数选择数据表，与name方法完全一样，可替代name方法；

不可以跨库操作，即不可指定数据库前缀；

不可以设置表别名(因为当前表名不简称)；

隐藏了太多的操作细节，不利于了解框架的运行流程，容易让初学者产生误解。

以下是官方手册的的描述：

注意：使用db助手函数默认每次都会重新连接数据库，而使用 Db::name 或者 Db::table 方法的话都 是单例的。db函数如果需要采用相同的链接，可以传入第三个参数，例如：

db('user',[],false)->where('id',1)->find();

db('user',[],false)->where('status',1)->select();

上面的方式会使用同一个数据库连接，第二个参数为数据库的连接参数，留空表示采用数据库配置文件的 配置。

小作业：

db()助手函数选择表操作，是最简洁的，连类引入都省略了，动手试一下吧~~