ThinkPHP`5.1`版本正式發(fā)布已經(jīng)有一段時間了,我會陸續(xù)給大家介紹其中的新特性。今天要給大家介紹的是一個可能很多用戶還不了解的一個特性:**JSON字段數(shù)據(jù)支持**。
>[info] 不過首先注意一點,本篇內(nèi)容中描述的JSON字段數(shù)據(jù)的支持是從`V5.1.4+`版本引入的。由于包含安全更新的原因,建議確保使用`5.1.9+`版本。
>[danger] 本篇中對`JSON`字段的定義包括`JSON`類型或者保存的數(shù)據(jù)為`JSON`格式的字符類型,所以理論上除了使用`JSON`字段條件查詢外,對數(shù)據(jù)庫類型和版本沒有要求。
>
## `Db`類操作`JSON`
如果你沒有使用模型類,`Db`類提供了一個`json`方法可以指定你的數(shù)據(jù)表`JSON`格式字段。例如你的`user`表有一個`info`字段是`JSON`類型的,你可以使用下面的方式操作數(shù)據(jù)。
### 數(shù)據(jù)寫入
~~~
$user['name'] = 'thinkphp';
$user['info'] = [
'email' => 'thinkphp@qq.com',
'nickname' => '流年',
];
Db::name('user')
->json(['info'])
->insert($user);
~~~
`json`方法的參數(shù)是一個數(shù)組,示例中指定了`info`字段,其實可以指定多個JSON類型字段。
### 數(shù)據(jù)查詢
查詢整個JSON數(shù)據(jù)使用。
~~~
$user = Db::name('user')
->json(['info'])
->find(1);
dump($user);
~~~
返回的查詢結(jié)果數(shù)據(jù)中,會自動包含一個數(shù)組類型的`info`數(shù)據(jù),也就是說JSON格式數(shù)據(jù)已經(jīng)自動`json_decode`處理。
>[info] 該方式查詢對`info`字段并非嚴(yán)格要求使用`JSON`類型
如果需要根據(jù)JSON數(shù)據(jù)的值進(jìn)行查詢,可以使用下面的方法
~~~
$user = Db::name('user')
->json(['info'])
->where('info->nickname','ThinkPHP')
->find();
dump($user);
~~~
>[danger] 要求`info`字段必須是`JSON`類型,MySQL需要`5.7+`版本才能支持
當(dāng)然,也可以支持多級
~~~
$user = Db::name('user')
->json(['info'])
->where('info->profile->nickname','ThinkPHP')
->find();
dump($user);
~~~
由于JSON字段的屬性類型并不會自動獲取,所以,如果是整型數(shù)據(jù)查詢的話,需要手動參數(shù)綁定,例如:
~~~
$user = Db::name('user')
->json(['info'])
->where('info->user_id', ':user_id')
->bind(['user_id' => [10, \PDO::PARAM_INT]])
->find();
dump($user);
~~~
### 數(shù)據(jù)更新
完整JSON數(shù)據(jù)更新
~~~
$data['info'] = [
'email' => 'kancloud@qq.com',
'nickname' => 'kancloud',
];
Db::name('user')
->json(['info'])
->where('id',1)
->update($data);
~~~
>[info] 該方式查詢對`info`字段并非嚴(yán)格要求使用`JSON`類型
如果只是更新`JSON`數(shù)據(jù)中的某個值,則可以使用下面的方法:
~~~
$data['info->nickname'] = 'ThinkPHP';
Db::name('user')
->json(['info'])
->where('id',1)
->update($data);
~~~
>[danger] 同樣要求`info`字段必須是`JSON`類型
## 模型操作`JSON`數(shù)據(jù)
如果你使用的是模型操作數(shù)據(jù)庫的話,那么`JSON`數(shù)據(jù)操作就更簡單了。
我們只要給`User`模型類增加一個`json`屬性定義即可。
~~~
<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
// 設(shè)置json類型字段
protected $json = ['info'];
}
~~~
json屬性同樣支持定義多個字段名稱,定義后,可以進(jìn)行如下JSON數(shù)據(jù)操作。
### 寫入數(shù)據(jù)
使用數(shù)組方式寫入JSON數(shù)據(jù):
~~~
$user = new User;
$user->name = 'thinkphp';
$user->info = [
'email' => 'thinkphp@qq.com',
'nickname '=> '流年',
];
$user->save();
~~~
使用對象方式寫入JSON數(shù)據(jù)
~~~
$user = new User;
$user->name = 'thinkphp';
$info = new StdClass();
$info->email = 'thinkphp@qq.com';
$info->nickname = '流年';
$user->info = $info;
$user->save();
~~~
### 查詢數(shù)據(jù)
和Db類查詢出來的結(jié)果類型不同,模型的`JSON`字段會自動轉(zhuǎn)換成對象方式。
~~~
$user = User::get(1);
echo $user->name; // thinkphp
echo $user->info->email; // thinkphp@qq.com
echo $user->info->nickname; // 流年
~~~
同樣也可以支持查詢`JSON`字段數(shù)據(jù)
~~~
$user = User::where('info->nickname','流年')->find();
echo $user->name; // thinkphp
echo $user->info->email; // thinkphp@qq.com
echo $user->info->nickname; // 流年
~~~
和Db類查詢一樣,如果你需要查詢的JSON屬性是整型類型的話,需要進(jìn)行手動參數(shù)綁定。
~~~
$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字段的屬性類型,就會自動進(jìn)行相應(yīng)類型的參數(shù)綁定查詢。
~~~
<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
// 設(shè)置json類型字段
protected $json = ['info'];
// 設(shè)置JSON字段的類型
protected $jsonType = [
'user_id' => 'int'
];
}
~~~
沒有定義類型的屬性默認(rèn)為字符串類型,因此字符串類型的屬性可以無需定義。
### 更新數(shù)據(jù)
更新JSON數(shù)據(jù)也是采用對象的方式
~~~
$user = User::get(1);
$user->name = 'kancloud';
$user->info->email = 'kancloud@qq.com';
$user->info->nickname = 'kancloud';
$user->save();
~~~
如果你需要對JSON類型字段做更復(fù)雜的操作,還可以通過`exp`表達(dá)式方式完成。這個就等待大家去發(fā)現(xiàn)更多的JSON用法了。
- 值得升級到5.1的18個理由
- 5.1.7版本新特性
- JSON字段類型在ORM中的使用
- 文件下載響應(yīng)對象
- 教你使用5.1的數(shù)組對象查詢
- 模型三大利器之一:搜索器
- 在ThinkPHP中使用Yaconf
- 掌握命令行的表格輸出
- 5.1.25查詢參數(shù)綁定的改進(jìn)
- ThinkPHP安全規(guī)范指引
- 巧用數(shù)據(jù)集的排序功能實現(xiàn)統(tǒng)計排序
- think-orm ——基于5.1的獨立ORM庫
- think-template——基于ThinkPHP的獨立模板引擎
- ThinkPHP5.1.26版本發(fā)布——修正版本,包含安全更新
- ThinkPHP5.0和3.2再發(fā)安全更新
- 官宣:ThinkPHP發(fā)布首個LTS版本
- 你真的了解Db類和模型的正確使用姿勢么?
- 如何更有效的記錄和管理日志
- 模型三大利器之二:修改器
- ThinkPHP5.1.28版本發(fā)布——修正上一版本問題,改進(jìn)關(guān)聯(lián)查詢
- 模型三大利器之三:獲取器
- API版本控制的幾種思路
- ThinkPHP5.2第一個Beta版本發(fā)布測試
- 讓你少犯錯的數(shù)據(jù)查詢基本原則
- ThinkPHP發(fā)布5.1.29版本——常規(guī)更新
- 這15個好習(xí)慣讓你更容易升級到5.2
- 如何有效提高ThinkPHP的應(yīng)用性能
- 讓你提高開發(fā)效率的查詢技巧
- 模型關(guān)聯(lián)查詢不完全指南
- 5.2發(fā)布Beta2版本——統(tǒng)一和精簡大量用法
- ThinkPHP發(fā)布5.1.30版本——支持微秒時間字段寫入
- ThinkPHP的數(shù)據(jù)緩存使用
- ThinkPHP5.2安裝及入口文件
- ThinkPHP榮獲2018 年度最受歡迎中國開源開發(fā)框架第1名
- 5.1路由使用心得技巧
- ThinkPHP5.*版本發(fā)布安全更新
- ThinkPHP項目及代碼規(guī)范指北
- 5.2版本的設(shè)計規(guī)范指導(dǎo)
- ThinkPHP5.1.32版本發(fā)布——圣誕快樂
- 利用Trait特性給模型增加樂觀鎖功能
- 5.2數(shù)據(jù)庫和模型的變化(摘要)
- ThinkPHP模板引擎實現(xiàn)和常見問題
- ThinkPHP5.0.24版本發(fā)布——安全更新
- 不忘初心,方得始終——ThinkPHP十三周年報告
- ThinkPHP5+相關(guān)資源匯總
- 異步社區(qū)ThinkPHP周年慶專享優(yōu)惠活動
- 5.2路由的調(diào)整和改進(jìn)
- ThinkPHP發(fā)布5.1.33版本——包含安全更新
- ThinkPHP擴(kuò)展開發(fā)指南
- ThinkPHP發(fā)布5.2Beta3版本
- ThinkPHP發(fā)布5.1.34版本——喜迎新年
- ThinkPHP發(fā)布5.2RC1版本
- ThinkPHP發(fā)布5.1.35版本——常規(guī)更新
- 5.2配置類的調(diào)整
- 5.2時間查詢的改進(jìn)和優(yōu)化
- 5.2RC版本升級不完全指導(dǎo)(僅供學(xué)習(xí)參考)
- ThinkPHP5.2版本正式變更為6.0版本
- ThinkPHP百度云云虛擬主機(jī)專享免費活動
- 事件系統(tǒng)以及查詢事件、模型事件的使用
- ThinkPHP6.0RC2版本發(fā)布——架構(gòu)升級、精簡核心
- ThinkPHP5.1.36LTS版本發(fā)布——常規(guī)更新
- 新版Session和Cookie設(shè)計變化
- ThinkPHP5.1.37版本發(fā)布——常規(guī)更新
- ThinkPHP6.0RC3版本發(fā)布——細(xì)節(jié)完善,體驗優(yōu)化
- 6.0中間件使用詳解
- Composer各大廠商鏡像地址
- ThinkPHP6.0發(fā)布計劃公告
- 「ThinkPHP開發(fā)者周刊」招募志愿者
- ThinkPHP6.0日志變化
- ThinkPHP5.1.38版本發(fā)布——常規(guī)更新
- ThinkPHP6.0RC4版本發(fā)布——ORM獨立,日志多通道支持
- ThinkORM2.0開發(fā)指南上線
- ThinkPHP6.0RC5版本發(fā)布——多應(yīng)用模式獨立,中間件機(jī)制調(diào)整
- ThinkPHP6.0版本發(fā)布——程序員節(jié)福利
- ThinkPHP5.1.39LTS版本發(fā)布——常規(guī)更新
- ThinkPHP6.0.1版本發(fā)布——圣誕快樂!
- 回顧2019,展望2020!
- ThinkPHPV6.0.2版本發(fā)布——2020新春快樂!
- 周年福利系列:Swoole合作優(yōu)惠
- 億速云成為ThinkPHPV6.0獨家贊助發(fā)布商??
- 新冠疫情工具和限免資源專題(保持更新中)
- 周年福利系列:創(chuàng)宇信用認(rèn)證合作優(yōu)惠
- 周年福利系列:碼云企業(yè)版限時10%優(yōu)惠
- 周年福利系列:想天短說抵現(xiàn)優(yōu)惠
- think-swoole直播:從零開始掌握swoole開發(fā)
- 周年福利系列:B2C開源電商ShopXO授權(quán)8折優(yōu)惠
- 周年福利系列:LayuiAdmin 永久授權(quán)限時優(yōu)惠
- ThinkPHP資源導(dǎo)航站上線——構(gòu)建生態(tài) 服務(wù)未來
- ThinkPHP官方技術(shù)支持服務(wù)和應(yīng)用服務(wù)市場上線公測
- ThinkPHP市場精選——推廣基本要素
- ThinkPHP市場精選——客服聊天專題
- ThinkPHPV6.0.3版本發(fā)布——端午安康
- ThinkPHP開發(fā)者扶持計劃
- 6.0.3版本關(guān)鍵更新及升級事項
- 「ThinkPHP開發(fā)者周刊」改版重啟
- ThinkPHP市場精選——企業(yè)建站專題
- ThinkPHP 提供統(tǒng)一API接口服務(wù)
- ThinkPHP市場精選——直播電商專題
- ThinkAPI服務(wù)SDK發(fā)布
- 官方服務(wù)市場啟用獨立子域名
- ThinkPHP市場精選——刷臉支付專題
- ThinkAPI推出會員服務(wù)計劃
- ThinkPHPV6.0.4版本發(fā)布——中秋國慶雙節(jié)快樂
- ThinkPHPV5.1.40版本發(fā)布——常規(guī)更新
- 1024程序員節(jié)福利走一波
- ThinkPHP V6.0.5版本發(fā)布——兼容Composer2.0
- 知識圖譜應(yīng)用場景——源論技術(shù)沙龍
- ThinkPHP5.*版本改進(jìn)Composer2.0的兼容
- 官方市場雙十一精選推薦
- 技術(shù)人做產(chǎn)品有機(jī)會么(文末送課程)
- 本周秒殺——古德云售后獲客營銷系統(tǒng)
- ThinkAPI服務(wù)更新——支持接口分組和PHP版本依賴調(diào)整
- PHP8新特性盤點
- PHP8新特性系列:構(gòu)造器屬性提升使用及注意事項
- ThinkPHP2021新年寄語
- ThinkPHP V6.0.6&V5.1.41版本發(fā)布——兼容PHP8.0
- PHP如何更優(yōu)雅地調(diào)用API接口
- ThinkPHP V6.0.7發(fā)布——修正版本
- ThinkAPI服務(wù)更新——IP白名單
- 最新版ThinkORM對于時間字段的調(diào)整
- ThinkAPI短信接口正式上線
- ThinkPHP V6.0.8版本發(fā)布——多環(huán)境變量配置支持
- 頂想云寫作服務(wù)開啟第一次公測
- ThinkSSL上線——官方SSL/TLS證書服務(wù)
- MDBootstrap國內(nèi)用戶福利——ThinkPHP官方市場首發(fā)
- ThinkPHP V6.0.9版本發(fā)布——常規(guī)更新
- ThinkORM功能盤點——虛擬模型
- 全面支持主流GIT版本庫——云寫作服務(wù)第二次公測
- 云寫作服務(wù)私有化部署方案之:版本庫私有化
- 看云雙十一活動
- ThinkPHP V6.0.10LTS發(fā)布——兼容PHP8.1
- ThinkPHP V6.0.12發(fā)布——命令行兼容8.1
- 頂想云知識管理上線公測——構(gòu)建企業(yè)文檔中心和知識庫
- 頂想云上線——助力生態(tài)數(shù)字化建設(shè)
- 618活動進(jìn)行中——官方市場迎來一波更新
- 頂想云知識管理正式上線——看云文檔啟動遷移服務(wù)
- ThinkPHP V6.0.13發(fā)布——常規(guī)更新
- 頂想云網(wǎng)站助理服務(wù)上線——構(gòu)建產(chǎn)品支持服務(wù)
- ThinkPHP發(fā)布6.1.0&6.0.14版本——安全更新
- ThinkPHP新版社區(qū)上線試運營
- ThinkAPI上架人臉核身接口——助力網(wǎng)站實名認(rèn)證
- 辭舊迎新——舊版社區(qū)停止注冊及發(fā)帖
- ThinkPHP6.1.2版本發(fā)布——兼容PHP8.2
