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 控制器代码:
namespace app\index\controller;
//导入数据库类
use think\Db;
class Index {
public function index(){
//查询表中id,name,salary字段,字段名用字符串
$result = Db::table('tp5_staff')
-> 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 控制器代码:
namespace app\index\controller;
//导入数据库类
use think\Db;
class Index {
public function index(){
//查询表中id,name,salary字段,字段名用别名表示
//创建字段别名数组
$fields['id'] = '工号';
$fields['name'] = '姓名';
$fields['salary'] = '工资';
$result = Db::table('tp5_staff')
-> 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 控制器代码:
namespace app\index\controller;
//导入数据库类
use think\Db;
class Index {
public function index(){
//查询表中除id,sex字段外,其它字段均显示
$result = Db::table('tp5_staff')
-> 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了~~~
经过总结,共有四种方式可以实现全部字段输出:
查询的链式操作中,不要写field方法,默认就是输出全部字段
dump( Db::table('tp5_staff') -> select(1010) );
field方法参数为空字符串
dump( Db::table('tp5_staff') ->field() -> select(1010) );
field方法参数为'*' 字符
dump( Db::table('tp5_staff') ->field( '*' ) -> select(1010) );
field方法参数为false ,全都不排除,即全部字段均显示出来
dump( Db::table('tp5_staff') ->field( false ) -> select(1010) );
这四种方法,我个人推荐用 field('*') ,感觉显示更直观一些。