ThinkPHPJSON数据怎么存_ThinkPHP模型JSON字段介绍【教程】

ThinkPHP 存 JSON 数据应使用 MySQL 5.7+ 的 JSON 字段类型配合 json(['info']) 方法写入数组，确保支持 info->email 查询；模型中配置 $json = ['info'] 可自动解码；缓存时直接存 json_encode() 字符串，勿用 serialize()。

在 ThinkPHP 中处理 JSON 数据，核心问题往往不在于“能不能存”，而在于“用什么方式存、在哪存、怎么查”。选择不当，后续按字段查询、类型保持、缓存读取都可能出问题，甚至直接导致 SQL 执行失败。

MySQL 5.7+ 必须用 JSON 字段类型 + json() 方法

如果你的数据库是 MySQL 5.7 或更高版本，并且表结构已经将 info 字段明确定义为 JSON 类型（而非 TEXT），那么就别再手动进行 json_encode() 然后插入了。ThinkPHP 6+ 提供的 json() 方法，其价值在于能自动触发数据库的原生 JSON 函数，这样写入更安全，后续的查询功能才能真正派上用场。

• 写入时直接传数组：Db::name('user')->json(['info'])->insert(['name' => '张三', 'info' => ['email' => 'zhang@example.com', 'tags' => ['php', 'tp6']]])
• 如果漏掉了 json() 调用，即使字段是 JSON 类型，ThinkPHP 也会将其当作普通字符串处理，直接后果就是后续的 -> 查询语法完全失效。
• 字段名必须显式地列在 json() 方法的参数里，例如 json(['info', 'config'])。漏写任何一个，那个字段在本次操作中就会退化为纯文本处理。

where('field->key', $value) 查询前必须确认字段已声明为 JSON

想用 info->email 这种语法来查询数据？光在写入时调用 json() 方法可不够，数据库字段本身必须是 JSON 类型。否则，MySQL 会直接报出 Invalid JSON text 错误，或者干脆返回空结果。

• 错误示范：Db::name('user')->where('info->email', 'zhang@example.com')->find() —— 如果 info 字段是 TEXT 类型，这条查询会静默失败，什么也查不到。
• 正确做法：建表时使用 info JSON 定义字段，写入时使用 json(['info']) 方法，查询时才能顺畅地使用 -> 语法。
• 对于 JSON 内部的整数型值（比如 info->uid），数据库默认会将其作为字符串进行比对。这时需要显式指定字段类型：setFieldType(['info->uid' => 'int'])，否则像 where('info->uid', 1001) 这样的查询很可能匹配不到数据。

模型里用 $json = ['info'] 比手动调 json() 更省心

如果你需要频繁操作某个 JSON 字段，那么在模型层进行统一配置，远比每次手动调用 json(['info']) 要可靠得多，并且还能自动处理数据读取时的解码。

立即学习“PHP免费学习笔记（深入）”；

• 在模型类中加入：protected $json = ['info'];。之后，所有通过 find()、select() 等方法获取到的 info 字段值，都会自动是 PHP 数组（效果等同于 json_decode($str, true)）。
• 更新整个 JSON 字段：$user->info = ['email' => 'new@ex.com']; $user->sa ve(); —— ThinkPHP 会自动识别并调用 JSON_SET 等原生函数。
• 只更新 JSON 内部的某个键：$user->sa ve(['info->nickname' => 'Tinywan'], ['id' => 1]);。这里需要注意，info->nickname 是作为一个整体字段名来处理的，并非嵌套赋值语法。

缓存 JSON 数据别碰 serialize()，直接存字符串

ThinkPHP 的缓存机制确实依赖 serialize() 来处理对象，但 JSON 数据本身并不是对象——它本质上是字符串。用 serialize() 再包装一层纯属浪费 CPU 资源，还可能因为序列化精度问题导致浮点数变形，或者把 null 值变成空数组。

• 正确姿势：cache('user_info_123', $json_string, 3600)。这里的 $json_string 直接就是 json_encode($data) 得到的结果字符串。
• 错误姿势：cache('user_info_123', serialize($json_string), 3600)。取出来时，你不得不先 unserialize() 再 json_decode()，完全是多此一举。
• 使用 APCu 或 Redis 等缓存驱动前，建议先校验：json_last_error() === JSON_ERROR_NONE，避免将无效的 JSON 字符串当作有效数据缓存进去。

最后，还有一个最容易被忽略的关键点：MySQL 的 JSON 字段不支持全文索引，也无法在 WHERE 子句中对 JSON 内部的字段使用 LIKE 进行模糊查询。如果确实有这类需求，必须提前将关键字段冗余到普通的表列中，或者考虑引入 Elasticsearch 这类搜索引擎作为补充方案。