field方法

field方法

1、功能：获取数据表中的指定字段名与值

该方法看似简单，实际上功能非常强大，用户看到的最终结果，全部由这个方法进行控制，一定要重视

2、源码：/thinkphp/library/think/db/Query.php

3、参数与返回值

• 该方法返回值与其它连贯方法一样，返回查询对象自身；

• 参数：

序号	参数	说明
1	$field字段列表 / mixed/(字符串、数组)	表中存在的字段列表
2	$except / 布尔	是否在结果中排除该字段，即不显示，默认为false，即不排除要显示
3	$tableName / 字符串	通常不需要指定，由前面的table/name/db等方法或函数设置
4	$prefix / 字符串	字段前缀，如果字段有前缀可设置，通常不设置
5	$alias / 表的别名前缀	通常不需要设置，别名就够用了

4、实例演示

任务1：查询tp5_staff表中id,name,salary字段

• Index.php 控制器代码：

 field('id,name,salary',false,'tp5_staff','','tp5_') ->select(1010); //查看结果 dump($result); } }

代码中是完整的写法：

-> field('id,name,salary',false,'tp5_staff','','tp5_')

• 可以这样写，与是一样的：

-> field('id,name,salary')

• field方法中的字段列表，用数组表示，这是推荐的方式

-> field(['id','name','salary'])

• 查询结果完全一样：

array(1) { [0] => array(3) { ["id"] => int(1010) ["name"] => string(9) "欧阳峰" ["salary"] => float(4900) } }

---

任务2：查询tp5_staff表中id,name,salary字段,用别名：工号、姓名、工资表示

• Index.php 控制器代码：

 field($fields) ->select(1010); //查看结果 dump($result); } }

• 当然也可以把字段别名数组直接写在field方法参数中：

$result = Db::table('tp5_staff') -> field(['id'=>'工号','name'=>'姓名','salary'=>'工资']) ->select(1010);

• 另外，直接用字符串原生SQL语句形式也可以实现：

$result = Db::table('tp5_staff') -> field('id as 工号, name as 姓名, salary as 工资') ->select(1010);

• 最终输出结果如下（字段名以中文直观显示）：

array(1) { [0] => array(3) { ["工号"] => int(1010) ["姓名"] => string(9) "欧阳峰" ["工资"] => float(4900) } }

以上二种（数组和字符串）设置字段别名的方式，显然数组方式更加灵活、优雅，便于扩展，也是我推荐使用的方式。

---

任务3：tp5_staff表中，除id,sex字段外，其它字段均显示用

• Index.php 控制器代码：

 field('id,sex',true) // 字段列表写在字符串中 ->select(1010); //查看结果 dump($result); } }

• 同理，将字段列表，直接写在数组中也可以：

//查询表中除id,sex字段外，其它字段均显示 $result = Db::table('tp5_staff') -> field(['id','sex'],true) // 字段列表写在数组中 ->select(1010);

• 二种写法输出结果是一样的：

array(1) { [0] => array(5) { ["name"] => string(9) "欧阳峰" ["age"] => int(28) ["salary"] => float(4900) ["dept"] => int(2) ["hiredate"] => string(10) "2013-09-22" } }

结果中，经过对比，并没有id,sex字段，可见也成功排除了这二个字段

---

任务4：获取所有字段信息

思考：我们应该如何做呢？是把全部字段名列出来吗？
当然不是，如果那样做，也太LOW了~~~
经过总结，共有四种方式可以实现全部字段输出：

1. 查询的链式操作中，不要写field方法，默认就是输出全部字段

dump( Db::table('tp5_staff') -> select(1010) );

1. field方法参数为空字符串

dump( Db::table('tp5_staff') ->field() -> select(1010) );

1. field方法参数为'*' 字符

dump( Db::table('tp5_staff') ->field( '*' ) -> select(1010) );

1. field方法参数为false ,全都不排除，即全部字段均显示出来

dump( Db::table('tp5_staff') ->field( false ) -> select(1010) );

这四种方法，我个人推荐用 field('*') ,感觉显示更直观一些。