ThinkPHP模型中仅配置$type='json'仅实现读取时自动json_decode,写入需配合$猗属性才能双向编解码;否则写入数组会报错,且数据库字段内容必须为合法JSON字符串。

ThinkPHP模型的type配置里写'json',只负责读取时自动json_decode,不负责写入时自动json_encode;真正实现双向自动编解码,必须同时配$json属性——光靠$type是半残的。
为什么$type = ['data' => 'json']读出来还是字符串?
因为$type仅控制「查询结果」的类型转换,且只在通过模型属性访问(如$model->data)或toArray()时触发;但前提是数据库字段值本身得是合法 JSON 字符串。如果字段在数据库里是NULL、空字符串、或存的是逗号分隔文本(如"a,b,c"),json_decode会直接返回null,不是数组。
- 检查原始值:
var_dump($model->getData('data')),确认是不是字符串形式的 JSON - MySQL 中用
SELECT JSON_VALID(`data`) FROM table验证字段内容是否真能被解析 -
$type不生效的常见原因:模型没继承think\Model、字段名大小写不一致、用了field()漏掉了该字段
$json和$type必须成对出现才真正启用自动编解码
单独写protected $type = ['data' => 'json'],只是让$model->data尝试json_decode;但$model->data = ['a'=>1]; $model->save()时,TP 不会自动json_encode,PDO 会报Array to string conversion错误。
- 正确做法:同时声明
protected $json = ['data']+protected $type = ['data' => 'json'] -
$json告诉 TP:“这个字段写入前要 encode,读取后要 decode”;$type则确保toArray()等方法也走同一套逻辑 - 缺一不可:只有
$json没有$type,getData('data')拿到的是原始字符串;只有$type没有$json,写入会失败
JSON 字段赋值时最容易踩的双重编码坑
手动json_encode后再赋值,会导致 TP 再 encode 一次,结果变成""{\"key\":\"val\"}"这种嵌套字符串。
一个基于官方 Mailtrap Node.js SDK 构建的 ASE 技能,用于发送事务邮件并与 Mailtrap 沙盒或生产流程协作。它非常适合需要 API 驱动邮件投递、测试邮箱验证和结构化消息自动化的代理工作流。
立即学习“PHP免费学习笔记(深入)”;
- ❌ 错误:
$model->data = json_encode(['key' => 'val']); $model->save(); - ✅ 正确:
$model->data = ['key' => 'val']; $model->save();(TP 自动 encode) - 批量赋值也一样:
$model->data(['data' => ['key' => 'val']])->save(); - 如果前端传的是 JSON 字符串(比如 AJAX POST 的
{"key":"val"}),先json_decode($input['data'], true)再塞进去,别直接存字符串
TP6 和 TP8 在 JSON 处理上的关键行为差异
TP8 默认对数据库类型为json的字段启用自动 decode(目标为array),但仅限find()/select()查出来的数据;而getData()、__get()仍可能返回原始字符串,取决于底层驱动是否注入了 typecast —— 这个细节极易被忽略。
- TP6:完全依赖
$json+$type显式声明,不声明=无处理 - TP8:有“默认行为”,但
$model->data和$model->getData('data')可能返回不同类型,建议统一用$json显式控制,避免环境差异 - 嵌套字段(如
settings.theme)TP 全系列都不支持直接声明,只能用getSettingsAttr访问器手动处理
最常被忽略的一点:JSON 字段的合法性校验不在 TP 模型层,而在你写入前。别指望$json能兜底非法结构,json_encode($bad_data)失败时 TP 不会抛异常,默认静默转空字符串——得自己加JSON_THROW_ON_ERROR或判空补默认值。


















