ThinkPHP`5.1`版本正式发布已经有一段时间了，我会陆续给大家介绍其中的新特性。今天要给大家介绍的是一个可能很多用户还不了解的一个特性：**JSON字段数据支持**。
>[info] 不过首先注意一点，本篇内容中描述的JSON字段数据的支持是从`V5.1.4+`版本引入的。由于包含安全更新的原因，建议确保使用`5.1.9+`版本。
>[danger] 本篇中对`JSON`字段的定义包括`JSON`类型或者保存的数据为`JSON`格式的字符类型，所以理论上除了使用`JSON`字段条件查询外的操作对数据库类型和版本没有要求。
>
## `Db`类操作`JSON`
如果你没有使用模型类，Db类提供了一个`json`方法可以指定你的数据表`JSON`格式字段，例如你的`user`表有一个`info`字段是`JSON`类型的，你可以使用下面的方式操作数据。
### 数据写入
~~~
$user['name'] = 'thinkphp';
$user['info'] = [
'email' => 'thinkphp@qq.com',
'nickname' => '流年',
];
Db::name('user')
->json(['info'])
->insert($user);
~~~
`json`方法的参数是一个数组，示例中指定了`info`字段，其实可以指定多个JSON类型字段。
### 数据查询
查询整个JSON数据使用。
~~~
$user = Db::name('user')
->json(['info'])
->find(1);
dump($user);
~~~
返回的查询结果数据中，会自动包含一个数组类型的`info`数据，也就是说JSON格式数据已经自动`json_decode`处理。
> 该方式查询对`info`字段并非严格要求使用`JSON`类型
如果需要根据JSON数据的值进行查询，可以使用下面的方法
~~~
$user = Db::name('user')
->json(['info'])
->where('info->nickname','ThinkPHP')
->find();
dump($user);
~~~
> 要求`info`字段必须是`JSON`类型，MySQL需要`5.7+`版本才能支持
>
当然，也可以支持多级
~~~
$user = Db::name('user')
->json(['info'])
->where('info->profile->nickname','ThinkPHP')
->find();
dump($user);
~~~
由于JSON字段的属性类型并不会自动获取，所以，如果是整型数据查询的话，需要手动参数绑定，例如：
~~~
$user = Db::name('user')
->json(['info'])
->where('info->user_id', ':user_id')
->bind('user_id', 10, \PDO::PARAM_INT)
->find();
dump($user);
~~~
### 数据更新
完整JSON数据更新
~~~
$data['info'] = [
'email' => 'kancloud@qq.com',
'nickname' => 'kancloud',
];
Db::name('user')
->json(['info'])
->where('id',1)
->update($data);
~~~
> 该方式查询对`info`字段并非严格要求使用`JSON`类型
如果只是更新`JSON`数据中的某个值，则可以使用下面的方法：
~~~
$data['info->nickname'] = 'ThinkPHP';
Db::name('user')
->json(['info'])
->where('id',1)
->update($data);
~~~
> 同样要求`info`字段必须是`JSON`类型
## 模型操作`JSON`数据
如果你使用的是模型操作数据库的话，那么`JSON`数据操作就更简单了。
我们只要给`User`模型类增加一个`json`属性定义即可。
~~~
<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
// 设置json类型字段
protected $json = ['info'];
}
~~~
json属性同样支持定义多个字段名称，定义后，可以进行如下JSON数据操作。
### 写入数据
使用数组方式写入JSON数据：
~~~
$user = new User;
$user->name = 'thinkphp';
$user->info = [
'email' => 'thinkphp@qq.com',
'nickname '=> '流年',
];
$user->save();
~~~
使用对象方式写入JSON数据
~~~
$user = new User;
$user->name = 'thinkphp';
$info = new StdClass();
$info->email = 'thinkphp@qq.com';
$info->nickname = '流年';
$user->info = $info;
$user->save();
~~~
### 查询数据
和Db类查询出来的结果类型不同，模型的`JSON`字段会自动转换成对象方式。
~~~
$user = User::get(1);
echo $user->name; // thinkphp
echo $user->info->email; // thinkphp@qq.com
echo $user->info->nickname; // 流年
~~~
同样也可以支持查询`JSON`字段数据
~~~
$user = User::where('info->nickname','流年')->find();
echo $user->name; // thinkphp
echo $user->info->email; // thinkphp@qq.com
echo $user->info->nickname; // 流年
~~~
和Db类查询一样，如果你需要查询的JSON属性是整型类型的话，需要进行手动参数绑定。
~~~
$user = User::where('info->user_id',':user_id')
->bind('user_id', 10 ,\PDO::PARAM_INT)
->find();
echo $user->name; // thinkphp
echo $user->info->email; // thinkphp@qq.com
echo $user->info->nickname; // 流年
~~~
如果你使用的是`V5.1.11+`版本的话，可以在模型类里面定义JSON字段的属性类型，就会自动进行相应类型的参数绑定查询。
~~~
<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
// 设置json类型字段
protected $json = ['info'];
// 设置JSON字段的类型
protected $jsonType = [
'user_id' => 'int'
];
}
~~~
没有定义类型的属性默认为字符串类型，因此字符串类型的属性可以无需定义。
### 更新数据
更新JSON数据也是采用对象的方式
~~~
$user = User::get(1);
$user->name = 'kancloud';
$user->info->email = 'kancloud@qq.com';
$user->info->nickname = 'kancloud';
$user->save();
~~~
如果你需要对JSON类型字段做更复杂的操作，还可以通过`exp`表达式方式完成。这个就等待大家去发现更多的JSON用法了。
