查询数据对象的 getData 方法

获取数据对象原始数据:getData()

所谓数据对象原始数据：其实就是对象的$data=[ ]数组的值

2. 源码

本教程如无特别说明：源码均指：Model.php 类文件中的内容。
 文件位置：/thinkphp/library/think/Model.php

    /**
     * 获取对象原始数据 如果不存在指定字段返回false
     * @access public
     * @param string $name 字段名 留空获取全部
     * @return mixed
     * @throws InvalidArgumentException
     */public function getData($name = null){if (is_null($name)) {  //如何不传参数return $this->data;   //返回整个数组(模型对象中与记录对应的字段集)} elseif (array_key_exists($name, $this->data)) { //参数键名是否$data中存在return $this->data[$name];  //返回当前数组元素,如:$data['name'],name为字段名} else {   //如果传入的键名在表中无对应字段对应,则返回错误信息throw new InvalidArgumentException('property not exists:' . $this->class . '->' . $name);
        }
    }

源码分析：如果该方法有参数，则把参数做为数组键名，返回对应的值；如果不传入任何参数，则返回整个$data数组

---

3. 参数与返回值

• 参数：

序号	参数	说明
1	$name/字符串	与数据对象$data属性对应的数组键名
2	无	不传入参数，则返回整个数据对象原始数据$data

• 返回值：

序号	条件	返回值
1	参数$name	与数据对象$data对应的数组元素值
2	无参数	返回整个数据对象原始数据$data数组
3	$name与$data键名不匹配	false 错误

---

4. 实例演示

1. 先创建一个自定义模型类，继承自Model类

   
   

   因为Model类是抽象类，必须定义他的子类才可以使用

• 模型文件:/application/index/model/Staff.php

<?php
namespace app\index\model;//导入模型类use think\model;class Staff extends model {//自定义模型类代码}

1. 控制器文件: Index.php

<?phpnamespace app\index\controller;//导入模型类use app\index\model\Staff;class Index {  public function index(){ 

      //1.创建模型对象$model  //此时的模型对象仅仅完成了与特定数据表的绑定  //理论上讲，仍是一个没有任何数据的空模型  $model = new Staff();      //2.创建数据源,供创建数据对象使用  $data = [];      $data['id'] = 1001;      $data['name'] = 'Peter';      $data['age'] = 26;      //3.data()方法完成前面模型对象的$data属性赋值  //使模型对象转换成数据对象,现在$model 已经是数据对象啦  $model -> data($data);      //4.getData()方法获取数据对象原始数据$data  $result = $model -> getData();    

      //5.查看数据对象原始数据:$data属性(数组类型)  dump($result); 

  }
}

• 现在打开浏览器运行Index控制器的index方法：

//以下就是数据对象的原始数据//其实就是将数据对象中$data属性值输出array(3) {
  ["id"] => int(1001)
  ["name"] => string(5) "Peter"
  ["age"] => int(26)
}

现在是输出了全部的原始数据，如果我们只需要其中一个元素，怎么做呢？

• getData方法参数传入键名字符串，可获取指定的单个原始数据元素

• 我们仅修改上面控制器代码第四步操作即可：

//4.getData()方法获取数据对象原始数据$data['name']的值$result = $model -> getData('name');

• 这样即可获取原始数据$data中的name键名对应的值：

string(5) "Peter"

---

4. 总结：

这个方法很灵活，即可获取完整的原始数据，也可以获取其中的一个数据。在开发也是最常用的方法，特别是在模板制作中用得很多，一定要熟练掌握。