TP5数据库操作方法总结
一.TP5数据库操作方法
1.name()方法
作用 : 指定默认的数据表名(不含前缀)
示例 : Db::name('weiba_post');
返回 : Db对象
2.setTable()方法
作用 : 指定默认数据表名(含前缀)
示例 : Db::setTable('op_weiba_post');
返回 : Db对象
3.getTable()方法
作用 : 得到当前或者指定名称的数据表(有前缀)
示例 : Db::getTable('weiba_post'); //返回op_weiba_post,带有表前缀,并且转换成了C风格
Db::getTable(); //返回由setTable()设置的表名称(官方所说的是返回 "当前" 表名称).
返回 : 表名(字符串)
4.parseSqlTable()方法
作用 : 将SQL语句中的__TABLE_NAME__字符串替换成带前缀的表名(小写)...此方法一般用不到,主要用于Db类自己调用
示例 : Db::parseSqlTable(__WEIBA_POST__); //返回op_weiba_post,带有表前缀,并且转换成了小写
返回 : 表名(字符串)
5.query()方法
参数 :
1.$sql 命令字符串[必填],
2.$bind=[] 绑定参数,默认空数组[选填],
3.$master=false,服务器序号(主从服务器有效),如果数据库没有配置主从服务器.则db类忽略该参数.一般用不到.[选填]
4.$class = false返回值处理方式.默认直接返回
true : PDO对象
类名 : 当前类处理
'' : 不做任何处理.直接返回
作用 : 执行查询 返回数据集(查询)
示例 : Db::query($sql); //返回查询结果
返回 : 返回查询结果(数组或对象)
6.execute()方法
参数 : $sql, $bind = [], $getLastInsID = false, $sequence = null
1.$sql 命令字符串[必填],
2.$bind=[] 绑定参数,默认空数组[选填],
3.$getLastInsID=false 是否返回上次插入的ID.如果true则返回上次上次插入ID.false返回影响行数.默认为false.[选填]
4.$sequence=null 如果没有为参数 sequence 指定序列名称，则返回一个表示最后插入数据库那一行的行ID的字符串。如果为参数 sequence 指定了序列名称，则返回一个表示从指定序列对象取回最后的值的字符串。如果当前 PDO 驱动不支持此功能，则触发一个 IM001 SQLSTATE 。
作用 : 执行语句(编辑)
示例 : Db::execute($sql); //返回一个整型的数字
返回 : 返回编辑结果,
7.getLastInsID()方法
作用 : 获取最近插入的ID
示例 : $id = Db::getLastInsID()
返回 : ID
8.getLastSql()方法
作用 : 获取最近一次查询的sql语句
示例 : $sql = Db::getLastSql()
返回 : sql命令,字符串类型
9.transaction()方法 php好强大...
参数 : 1.$callback,回调函数[可选]
作用 : 执行数据库事务,回调函数执行成功则提交事务,否则回滚
示例 : Db::transaction($this->update($data));
返回 : 回调函数的返回值
10.startTrans()方法
作用 : 开启事务
示例 : Db::startTrans()
返回 : 失败返回假,成功无返回值,注意false跟null的区别(===)
11.commit()方法
作用 : 用于非自动提交状态下面的查询提交
示例 : Db::commit()
返回 : 无返回值
12.rollback()方法
作用 : 事务回滚
示例 : Db::rollback();
返回 : 无返回值
13.batchQuery()方法
参数 : 就一个.类型必须是数组.否则直接返回假
作用 : 批处理执行SQL语句,强制认为是编辑操作,内部启动了事务.也就是说要么都成功.要么都失败(失败会抛出一个异常)
示例 : Db::batchQuery($arr);//参数是sql命令数组
返回 : 总是返回true
14.getConfig()方法
作用 : 返回数据库配置参数
示例 : $config = Db::getConfig();
返回 : 配置信息
15.getPartitionTableName()方法
作用 : 得到分表的的数据表名(用到再说吧.说不定要改写.)
示例 :
返回 : 表名
16.value()方法
参数 : 1.字段.2默认值
作用 : 得到某个字段的值
示例 : Db::table('op_user')->value('uid' , false);
作用 : 得到某个字段的值
17.column()方法
参数 :
1.字段名.多个用逗号隔开[必填]
2.索引字段[选填]
作用 : 得到某个列的数组
示例 : 不想写
作用 : 这就是value()方法组团来的...
18.count()方法
参数 : 他的参数默认是*,建议以后使用的时候用0
作用 : COUNT查询,数量
示例 : Db::table('op_user')->count(0);
返回 : 数量
19.sum()方法
参数 : 默认是*.建议改
作用 : 求和
示例 : Db::table('op_user')->sum('uid'); //uid的总数,好神奇的需求...
返回 : 数量
20.min()方法
参数 : 默认是*.建议改
作用 : 求最小值
示例 : Db::table('op_user')->min(`uid`); //最小uid
返回 : 字段值
21.max()方法
参数 : 默认是*.建议改
作用 : 求最大值
示例 : Db::table('op_user')->max(`uid`); //最大uid
返回 : 字段值
22.avg()方法
参数 : 默认是*.建议改
作用 : 求平均值
示例 : Db::table('op_user')->avg(`uid`); //最大uid
返回 : 字段值
23.setField()方法
参数 : 可以是数组,也可以是字符串
作用 : 修改某一字段的值(内部调用的update)
示例 :
Db::table('op_user')->where(['uid'=>1])->setField('phone' , '110');
Db::table('op_user')->where(['uid'=>1])->setField(['phone' => '110']);
返回 : 影响行数
24.setInc()方法
参数 :
1.$field:同setField().归根结底还是调用的update
2.$step : 增长值
3.$lazyTime : 延迟时间,大于0时才延迟
作用 : 延迟更新.保存在缓存中.Db类自动调用.
25.setDec()方法
参数 :
1.$field:同setField().归根结底还是调用的update
2.$step : 减少值
3.$lazyTime : 延迟时间,大于0时才延迟
作用 : 同setInc()方法
26.join()方法
参数 :
1.表名,支持__WEIBA_POST__,
2.on条件.可以是字符串.也可以是数组.如果是数组连接用的and.
3.join类型.left,right,inner
注意.如果只传一个参数,必须为数组.格式就是上面的三个值,否则报错.
作用 : 关联查询
示例 :
Db::table('aa')->join('__BB__','aa.id=bb.id and aa.name=bb.name','left'); //aa left join bb on aa.id=bb.id and aa.name=bb.name
Db::table('aa')->join('bb',['aa.id=bb.id','aa.name=bb.name'],'left'); ////aa left join bb on aa.id=bb.id and aa.name=bb.name
Db::table('op_user as u')->field('u.uid')->join(['op_bz_binzhouq'=>'q'] , 'u.uid = q.uid' , 'left')->select(); //SELECT u.uid FROM op_user as u LEFT JOIN op_bz_binzhouq q ON u.uid = q.uid
27.union()方法
参数 :
1.$union,可以是数组,也可以是字符串
2.$all,有值UNION ALL ,否则为UNION
作用 : 合并结果集
示例 : Db::union($union , true);
28.field()方法
参数 :
1.$field:true全部字段,字符串(自动去重)
2.真假,是否去重,如果$field是全部字符串(true)时,不支持去重.
3.$tableName:表名.会组成$tableName.$field的形式
后面还有俩参数...用不到了...
作用 : 指定field字段
示例 : Db::field('id, name' , 0,'user')->field('pid , pname , psex' , 0 , 'ping') //user.id , user.name , ping.pid , ping.pname , ping.psex
29.view()方法
参数 :
1.$join : 表名
2.$field : 字段名
3.$on : 关联条件,同join方法
4.$type : 关联类型.left.right
作用 : 该方法设置的字段会在前面加上表
示例 : Db::table('user')->field('uid' , 0 , 'user')->view('binzhour' , 'name' , 'user.uid=binzhour.uid' , 'left')->select();
//select `user`.`uid` , `binzhour`.`name` from `user` left join `binzhour` on `user`.`uid` = `binzhour`.`uid`;
30.partition()方法
参数 :
1.data,
2.field,
3.rule[可选]
作用 : 设置分表规则,内部调用的getPartitionTableName()方法
示例 : 见getPartitionTableName方法
31.where()方法
参数 :
1.field 查询字段
2.op[可选] 查询表达式
3.condition 查询条件
作用 : 指定AND查询条件.内部调用的 parseWhereExp()方法,
示例 : 详见 parseWhereExp() 方法
32.whereOr()方法
参数 : 同where()方法
作用 : 指定OR查询条件.与where唯一不同的是用or连接.内部调用的 parseWhereExp() 方法
示例 : 详见 parseWhereExp() 方法
33.whereXor()方法
参数 : 同where()方法
作用 : 异或,两边布尔值相同为假.不同为真.内部调用的 parseWhereExp() 方法
示例 : 详见 parseWhereExp() 方法
34.limit()方法
参数 :
1.起始位置
2.查询数量
作用 : 指定查询数量
示例 : limit(0 , 20);
35.page()方法
参数 :
1.页数[必选]
2.每页数量,[可选 20].
作用 : 指定分页
示例 : page(1,20); //第一页.每页20条.
36.table()方法
参数 :
1.表名
作用 : 指定当前操作的数据表
示例 : table('tableName')
37.using()方法(不知道用法...)
参数 :
1.字段名
作用 : USING支持
示例 : select a.*, b.* from a left join b using(colA); 等同于 select a.*, b.* from a left join b on a.colA = b.colA;
38.order()方法
参数 :
1.字段名
2.排序
作用 : 排序
示例 : order('id','desc') 或者 order(['id'=>'desc','create_time'=>'desc'])
39.cache()方法
参数 :
1.缓存KEY.
2.缓存有效期.
作用 : 查询缓存
返回对象...
示例 : cache('id' , 10)
40.group()方法
参数 : 1.字段名
作用 : 分组查询
示例 :
41.having()方法
42.distinct()方法
43.alias()方法.别名
44.force()方法
参数 : 索引名
作用 : 强制使用索引,不使用其他索引
45.comment()方法
参数 : 注释内容
作用 : 给sql命令写注释.
示例 : Db::name('bz_live')->comment('好无聊的方法')->find(); 等同于 SELECT * FROM `op_bz_live` LIMIT 1 /* 好无聊的方法 */
46.fetchSql()方法
参数 : 写true
作用 : 返回sql语句
示例 : $sql = Db::name('bz_live')->fetchSql(true)->select();
47.fetchPdo()方法
参数 : 写true
作用 : 返回 PDOStatement 对象
示例 : Db::name('bz_live')->fetchPdo(true)->select();
48.strict()方法
参数 : true/false
作用 : 是否严格检查字段名
示例 :
49.failException()方法
参数 : true/false
作用 : 设置查询数据不存在是否抛出异常
