field方法主要作用是标识要返回或者操作的字段,可以用于查询和写入操作。

1. 用于查询

1.1 指定查询字段

指定需要查询的字段

  1. <?php
  2. // 用于查询
  3. public function fun8()
  4. {
  5. $data = Db::table('wh_record')
  6. ->where([
  7. ['IDX', '>', 150000],
  8. ['UNIT', '=', 2],
  9. ['STATUS', 'IN', ['归还', '借出']],
  10. ])
  11. ->field('IDX, BUILD, ISN, STATUS')
  12. ->select();
  13. return json($data);
  14. }

1.2 字段设置别名

可以给字段设置别名

  1. <?php
  2. // 可以设置别名
  3. public function fun9()
  4. {
  5. $data = Db::table('wh_record')
  6. ->where([
  7. ['IDX', '>', 150000],
  8. ['UNIT', '=', 2],
  9. ['STATUS', 'IN', ['归还', '借出']],
  10. ])
  11. ->field('IDX AS ID, BUILD AS 阶段, ISN AS 序列号, STATUS AS 状态')
  12. ->select();
  13. return json($data);
  14. }

1.3 使用SQL函数

可以在field方法中直接使用函数,例如:

  1. <?php
  2. Db::table('think_user')->field('id,SUM(score)')->select();

执行的SQL相当于:

  1. SELECT id,SUM(score) FROM think_user

除了select方法之外,所有的查询方法,包括find等都可以使用field方法。

V5.1.7+版本开始,如果需要使用SQL函数,推荐使用下面的方式:

  1. <?php
  2. Db::table('think_user')->fieldRaw('id,SUM(score)')->select();

1.4 使用数组参数

field方法的参数可以支持数组,例如:

  1. <?php
  2. Db::table('think_user')->field(['id','title','content'])->select();

数组方式的定义可以为某些字段定义别名,例如:

  1. <?php
  2. Db::table('think_user')->field(['id','nickname'=>'name'])->select();

执行的SQL相当于:

  1. SELECT id,nickname as name FROM think_user

对于一些更复杂的字段要求,数组的优势则更加明显,例如:

  1. <?php
  2. Db::table('think_user')
  3. ->field(
  4. [
  5. 'id','concat(name,"-",id)' =>'truename',
  6. 'LEFT(title,7)' =>'sub_title'
  7. ]
  8. )
  9. ->select();

执行的SQL相当于:

  1. SELECT id,concat(name,'-',id) as truename,LEFT(title,7) as sub_title FROM think_user

对于带有复杂SQL函数的字段需求必须使用数组方式

1.5 获取所有字段

如果有一个表有非常多的字段,需要获取所有的字段(这个也许很简单,因为不调用field方法或者直接使用空的field方法都能做到):

  1. <?php
  2. Db::table('think_user')->select();
  3. Db::table('think_user')->field('*')->select();

上面的用法是等效的,都相当于执行SQL:

  1. SELECT * FROM think_user

但是这并不是我说的获取所有字段,而是显式的调用所有字段(对于对性能要求比较高的系统,这个要求并不过分,起码是一个比较好的习惯),下面的用法可以完成预期的作用:

  1. <?php
  2. Db::table('think_user')->field(true)->select();

field(true)的用法会显式的获取数据表的所有字段列表,哪怕你的数据表有100个字段。

1.6 字段排除

希望获取排除数据表中的content字段(文本字段的值非常耗内存)之外的所有字段值,我们就可以使用field方法的排除功能,例如下面的方式就可以实现所说的功能:

  1. <?php
  2. Db::table('think_user')->field('content',true)->select();

则表示获取除了content之外的所有字段,要排除更多的字段也可以:

  1. <?php
  2. Db::table('think_user')->field('user_id,content',true)->select();
  3. //或者用
  4. Db::table('think_user')->field(['user_id','content'],true)->select();

注意的是 字段排除功能不支持跨表和join操作。


2. 用于写入

除了查询操作之外,field方法还有一个非常重要的安全功能—字段合法性检测field方法结合数据库的写入方法使用就可以完成表单提交的字段合法性检测,如果我们在表单提交的处理方法中使用了:

  1. <?php
  2. Db::table('think_user')->field('title,email,content')->insert($data);

即表示表单中的合法字段只有title,emailcontent字段,无论用户通过什么手段更改或者添加了浏览器的提交字段,都会直接屏蔽。因为,其他所有字段我们都不希望由用户提交来决定,你可以通过自动完成功能定义额外需要自动写入的字段。

在开启数据表字段严格检查的情况下,提交了非法字段会抛出异常,可以在数据库设置文件中设置:

  1. <?php
  2. // 关闭严格字段检查
  3. 'fields_strict' => false,