ThinkPHP中JSON字段類型的使用示例

這篇文章主要介紹ThinkPHP中JSON字段類型的使用示例，文中介紹的非常詳細(xì)，具有一定的參考價(jià)值，感興趣的小伙伴們一定要看完！

ThinkPHP5.1版本正式發(fā)布已經(jīng)有一段時(shí)間了，我會(huì)陸續(xù)給大家介紹其中的新特性。今天要給大家介紹的是一個(gè)可能很多用戶還不了解的一個(gè)特性：JSON字段數(shù)據(jù)支持。

不過(guò)首先注意一點(diǎn)，本篇內(nèi)容中描述的JSON字段數(shù)據(jù)的支持是從V5.1.4+版本引入的。由于包含安全更新的原因，建議確保使用5.1.9+版本。

本篇中對(duì)JSON字段的定義包括JSON類型或者保存的數(shù)據(jù)為JSON格式的字符類型，所以理論上除了使用JSON字段條件查詢外，對(duì)數(shù)據(jù)庫(kù)類型和版本沒(méi)有要求。

Db類操作JSON

如果你沒(méi)有使用模型類，Db類提供了一個(gè)json方法可以指定你的數(shù)據(jù)表JSON格式字段。例如你的user表有一個(gè)info字段是JSON類型的，你可以使用下面的方式操作數(shù)據(jù)。

數(shù)據(jù)寫(xiě)入

$user['name'] = 'thinkphp';
$user['info'] = [
'email'    => 'thinkphp@qq.com',
'nickname' => '流年',
];
Db::name('user')
->json(['info'])
->insert($user);

json方法的參數(shù)是一個(gè)數(shù)組，示例中指定了info字段，其實(shí)可以指定多個(gè)JSON類型字段。

數(shù)據(jù)查詢

查詢整個(gè)JSON數(shù)據(jù)使用。

$user = Db::name('user')
->json(['info'])
->find(1);
dump($user);

返回的查詢結(jié)果數(shù)據(jù)中，會(huì)自動(dòng)包含一個(gè)數(shù)組類型的info數(shù)據(jù)，也就是說(shuō)JSON格式數(shù)據(jù)已經(jīng)自動(dòng)json_decode處理。

該方式查詢對(duì)info字段并非嚴(yán)格要求使用JSON類型

如果需要根據(jù)JSON數(shù)據(jù)的值進(jìn)行查詢，可以使用下面的方法

$user = Db::name('user')
->json(['info'])
    ->where('info->nickname','ThinkPHP')
->find();
dump($user);

要求info字段必須是JSON類型，MySQL需要5.7+版本才能支持

當(dāng)然，也可以支持多級(jí)

$user = Db::name('user')
->json(['info'])
    ->where('info->profile->nickname','ThinkPHP')
->find();
dump($user);

由于JSON字段的屬性類型并不會(huì)自動(dòng)獲取，所以，如果是整型數(shù)據(jù)查詢的話，需要手動(dòng)參數(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);

該方式查詢對(duì)info字段并非嚴(yán)格要求使用JSON類型

如果只是更新JSON數(shù)據(jù)中的某個(gè)值，則可以使用下面的方法：

$data['info->nickname'] = 'ThinkPHP';
Db::name('user')
->json(['info'])
    ->where('id',1)
->update($data);

同樣要求info字段必須是JSON類型

模型操作JSON數(shù)據(jù)

如果你使用的是模型操作數(shù)據(jù)庫(kù)的話，那么JSON數(shù)據(jù)操作就更簡(jiǎn)單了。

我們只要給User模型類增加一個(gè)json屬性定義即可。

<?php
namespace app\index\model;
use think\Model;
class User extends Model
{
// 設(shè)置json類型字段
protected $json = ['info'];
}

json屬性同樣支持定義多個(gè)字段名稱，定義后，可以進(jìn)行如下JSON數(shù)據(jù)操作。

寫(xiě)入數(shù)據(jù)

使用數(shù)組方式寫(xiě)入JSON數(shù)據(jù)：

$user = new User;
$user->name = 'thinkphp';
$user->info = [
'email'    => 'thinkphp@qq.com',
    'nickname '=> '流年',
];
$user->save();

使用對(duì)象方式寫(xiě)入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類查詢出來(lái)的結(jié)果類型不同，模型的JSON字段會(huì)自動(dòng)轉(zhuǎn)換成對(duì)象方式。

$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)行手動(dòng)參數(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字段的屬性類型，就會(huì)自動(dòng)進(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'
    ];
}

沒(méi)有定義類型的屬性默認(rèn)為字符串類型，因此字符串類型的屬性可以無(wú)需定義。

更新數(shù)據(jù)

更新JSON數(shù)據(jù)也是采用對(duì)象的方式

$user = User::get(1);
$user->name = 'kancloud';
$user->info->email = 'kancloud@qq.com';
$user->info->nickname = 'kancloud';
$user->save();

如果你需要對(duì)JSON類型字段做更復(fù)雜的操作，還可以通過(guò)exp表達(dá)式方式完成。這個(gè)就等待大家去發(fā)現(xiàn)更多的JSON用法了。

以上是“ThinkPHP中JSON字段類型的使用示例”這篇文章的所有內(nèi)容，感謝各位的閱讀！希望分享的內(nèi)容對(duì)大家有幫助，更多相關(guān)知識(shí)，歡迎關(guān)注億速云行業(yè)資訊頻道！