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] 该方式查询对`info`字段并非严格要求使用`JSON`类型 如果需要根据JSON数据的值进行查询,可以使用下面的方法 ~~~ $user = Db::name('user') ->json(['info']) ->where('info->nickname','ThinkPHP') ->find(); dump($user); ~~~ >[danger] 要求`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] 该方式查询对`info`字段并非严格要求使用`JSON`类型 如果只是更新`JSON`数据中的某个值,则可以使用下面的方法: ~~~ $data['info->nickname'] = 'ThinkPHP'; Db::name('user') ->json(['info']) ->where('id',1) ->update($data); ~~~ >[danger] 同样要求`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用法了。