ThinkPHP模型如何实现数据自动序列化_JSON字段类型转换技巧-ThinkPHP-PHP中文网

ThinkPHP默认不自动处理JSON字段，需在模型中声明$json和$jsonType属性；TP6必须显式配置，TP8虽默认解码但行为不一致，推荐统一使用访问器控制。

thinkphp模型如何实现数据自动序列化_json字段类型转换技巧

ThinkPHP模型里JSON字段不自动转数组？先看`json`类型字段是否真被识别

ThinkPHP 6.x 默认不会对数据库字段类型为 json 的字段做自动序列化/反序列化，哪怕你用的是 MySQL 5.7+ 或 PostgreSQL。它只把值当字符串读进来，toArray() 后还是字符串，不是数组。

确认数据库字段类型是 json（MySQL）或 jsonb/json（PostgreSQL），不是 text 或 varchar
检查模型类是否继承 thinkModel（TP6）或 thinkmodelBase（TP8），旧版手动继承 thinkModel 才有基础 JSON 支持
TP6 中需在模型中显式声明 protected $json = ['extra', 'config'];，否则字段值始终为字符串

怎么让`extra`字段读取时自动`json_decode`、写入时自动`json_encode`？

靠模型的 $json 属性 + $jsonType 配合控制行为，不是靠数据库驱动自动处理。

protected $json = ['extra'];：声明该字段需要 JSON 编解码（读取时 json_decode，写入时 json_encode）
protected $jsonType = ['extra' => 'array'];：指定解码目标类型，可选 array / object / string（后者等价于不 decode）
如果字段名含点号（如 settings.theme），TP 不支持嵌套字段声明，只能手动处理或改用 getExtraAttr 访问器
注意：$json 声明后，$model->extra 是数组，但 $model->getData('extra') 返回原始字符串（未 decode 的原始值）

`save()`时JSON字段被转成字符串再存？检查`setAttr`和`data`传入方式

常见错误是手动调用 json_encode 后再赋值，导致双重编码："{"name":"a"}" → 写库变成 ""{\"name\":\"a\"}""。

直接赋值数组即可：$model->extra = ['name' => 'a']; $model->save();，TP 会自动 encode
避免 $model->extra = json_encode(['name' => 'a']);，这会让 TP 再 encode 一次
用 data() 批量赋值时，同样传原生数组：$model->data(['extra' => ['name' => 'a']])->save();
如果用了 allowField(true) 且 POST 数据里 extra 是字符串（如前端传了 JSON 字符串），需先 json_decode($input['extra'], true) 再塞进 data

TP6 和 TP8 在 JSON 字段处理上的关键差异

TP8 把 JSON 处理逻辑下放到数据库查询构建器层，模型层更“薄”，但默认行为反而更容易踩坑。

TP6：依赖模型 $json + $jsonType，不声明就无自动处理
TP8：默认对 json 类型字段启用自动 decode（目标类型为 array），但仅限于通过 find/select 查询出的字段；getData() 或 __get() 访问仍可能返回字符串，取决于底层驱动是否注入了 typecast
TP8 中若字段在数据库里是 text 但内容是 JSON，TP 不会自动处理——必须靠访问器或手动 decode
跨版本迁移时，别假设 $json 声明在 TP8 里还起同样作用；建议统一用访问器 getExtraAttr 控制行为，更可控

JSON 字段真正难的不是存和取，而是混合使用原生 SQL 查询、whereJsonContains、聚合函数时，类型隐式转换容易失效。比如 where('extra->name', 'like', '%a%') 在 MySQL 里走的是 JSON 路径表达式，TP 不会帮你 decode，这时候字段值类型就和模型层完全脱钩了。