Thinkphp5.1版本正式發布已經有一段時間了，我會陸續給大家介紹其中的新特性。今天要給大家介紹的是一個可能很多用戶還不了解的一個特性：json字段數據支持。
不過首先注意一點，本篇內容中描述的JSON字段數據的支持是從V5.1.4+版本引入的。由于包含安全更新的原因，建議確保使用5.1.9+版本。本篇中對JSON字段的定義包括JSON類型或者保存的數據為JSON格式的字符類型，所以理論上除了使用JSON字段條件查詢外，對數據庫類型和版本沒有要求。
Db類操作JSON
如果你沒有使用模型類，Db類提供了一個json方法可以指定你的數據表JSON格式字段。例如你的user表有一個info字段是JSON類型的，你可以使用下面的方式操作數據。
數據寫入
立即學習“PHP免費學習筆記（深入）”；
$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 appindexmodel; use thinkModel; 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 appindexmodel; use thinkModel; 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用法了。
PHP中文網，有大量免費的ThinkPHP入門教程，歡迎大家學習！
