PHP语言ORM类库ThinkORM玩转JSON数据类型

ThinkORM是一个基于PHP和PDO的数据库中间层和ORM类库，以优异的功能和突出的性能著称，现已经支持独立使用，并作了升级改进，提供了更优秀的性能和开发体验，最新版本要求PHP8.0+。

安装

composer require topthink/think-orm

数据库 JSON

如果你的user表有一个info字段是JSON类型的（或者说你存储的是JSON格式，但并非是要JSON字段类型），你可以使用下面的方式操作数据。

JSON 数据写入

数据库写入json字段，直接通过数据的方式插入即可完成.

$data = [
    \\\'id\\\' => 2024,
    \\\'username\\\' => \\\'Tinywan\\\',
    \\\'info\\\' => [
        \\\'email\\\' => \\\'756684177@qq.com\\\', 
        \\\'gender\\\' => \\\'女\\\',
        \\\'age\\\' => 24
    ]
];

$res = think\\\\facade\\\\Db::table(\\\'user\\\')->json([\\\'info\\\'])->insert($data);

JSON 数据查询

查询整个JSON数据

如果要查询数据时，正确转换json数据，也需要设置json方法

$user = think\\\\facade\\\\Db::table(\\\'user\\\')->json([\\\'info\\\'])->find(1);
dump($user);

查询条件为JSON数据

如果将json字段数据作为查询条件，可以通过如下方式实现

$user = think\\\\facade\\\\Db::table(\\\'user\\\')
->json([\\\'info\\\'])
->where(\\\'info->email\\\',\\\'756684177@qq.com\\\')
->find();
dump($user);

由于JSON字段的属性类型并不会自动获取，所以，如果是整型数据查询的话，可以设置JSON字段类型，例如：

$user = think\\\\facade\\\\Db::name(\\\'user\\\')
 ->json([\\\'info\\\'])
    ->where(\\\'info->user_id\\\', 10)
 ->setFieldType([\\\'info->user_id\\\' => \\\'int\\\'])
 ->find();
dump($user);

JSON 数据更新

完整JSON数据更新

$data[\\\'info\\\'] = [
    \\\'email\\\' => \\\'tinywan@qq.com\\\',
    \\\'nickname\\\' => \\\'Tinywan\\\',
];
think\\\\facade\\\\Db::table(\\\'user\\\')
    ->json([\\\'info\\\'])
    ->where(\\\'id\\\', 2024)
    ->update($data);

单个JSON数据更新

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

模型 JSON

这里指的JSON数据字段包括JSON类型以及JSON格式数据（但并不是JSON类型字段）。

User模型类

<?php
namespace app\\\\model;

use think\\\\Model;
class User extends Model
{
 // 设置json类型字段
 protected $json = [\\\'info\\\'];
}

定义后，可以进行如下JSON数据操作。

写入JSON数据

使用数组方式写入JSON数据：

$user = new User;
$user->name = \\\'Tinywan\\\';
$user->info = [
    \\\'email\\\'    => \\\'Tinywan@qq.com\\\',
    \\\'nickname \\\'=> \\\'阿克苏\\\',
];
$user->save();

使用对象方式写入JSON数据

$user = new User;
$user->name = \\\'Tinywan\\\';
$info = new \\\\StdClass();
$info->email = \\\'Tinywan@qq.com\\\';
$info->nickname = \\\'阿克苏\\\';
$user->info = $info;
$user->save();

查询JSON数据

$user = User::find(1);
echo $user->name; // Tinywan
echo $user->info->email; // Tinywan@qq.com
echo $user->info->nickname; // 阿克苏

查询条件为JSON数据

$user = User::where(\\\'info->nickname\\\', \\\'阿克苏\\\')->find();
echo $user->name; // Tinywan
echo $user->info->email; // Tinywan@qq.com
echo $user->info->nickname; // 阿克苏

更新JSON数据

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

如果设置模型的JSON数据返回数组，那么更新操作需要调整如下。

$user = User::find(1);
$user->name = \\\'Tinywan\\\';
$info[\\\'email\\\'] = \\\'Tinywan@qq.com\\\';
$info[\\\'nickname\\\'] = \\\'Tinywan\\\';
$user->info = $info;
$user->save();

更多：https://blog.csdn.net/mayidream/article/details/105083871

JSON 对象查询

rest_day_rule 字段存储数据结构如下

{\\\"start_time\\\": \\\"09:00\\\"}

原生SQL查询

SELECT * FROM attendance_group WHERE rest_day_rule->\\\'$.start_time\\\' = \\\'09:00\\\'

ORM模型查询

$user = think\\\\facade\\\\Db::table(\\\'attendance_group\\\')
->json([\\\'rest_day_rule\\\'])
->where(\\\'rest_day_rule->start_time\\\',\\\'09:00\\\')
->find();

JSON 数组查询

config 字段存储数据结构如下

[
    {
        \\\"shift_id\\\": 1,
        \\\"is_checked\\\": 1,
        \\\"shift_name\\\": \\\"通用班次\\\",
        \\\"shift_time\\\": \\\"09:00-18:00\\\",
        \\\"worker_name\\\": \\\"周一\\\"
    },
    {
        \\\"shift_id\\\": 2,
        \\\"is_checked\\\": 1,
        \\\"shift_name\\\": \\\"通用班次\\\",
        \\\"shift_time\\\": \\\"09:00-18:00\\\",
        \\\"worker_name\\\": \\\"周二\\\"
    }
]

原生SQL查询

SELECT * FROM attendance_group_time WHERE JSON_CONTAINS(config, JSON_OBJECT(\\\'shift_id\\\',1))

ORM模型查询

$shiftId = 1;
$attendanceGroupTime = AttendanceGroupTimeModel::json([\\\'config\\\'])
->whereRaw(\\\'JSON_CONTAINS(config, JSON_OBJECT(\\\"shift_id\\\",\\\' . $shiftId . \\\'))\\\')
->findOrEmpty();

AttendanceGroupTimeModel 模型类

class AttendanceGroupTimeModel extends BaseModel
{
    /** 设置当前模型对应的完整数据表名称 */
    protected $table = \\\'attendance_group_time\\\';
    
    /** 设置当前模型对应的JSON字段 */
    protected $json = [\\\'config\\\'];
}