ThinkPHP数据库配置中的JSON字段解析：MySQL 8.0+在ThinkPHP中的高级查询与写入-ThinkPHP-PHP中文网

thinkphp不识别json路径语法，where('data.status', 'active')被解析为查询data表的status字段，而非json列data中的status键；正确写法是where('data->>status', 'active')（需mysql≥5.7且字段类型为json）。

thinkphp数据库配置中的json字段解析：mysql 8.0+在thinkphp中的高级查询与写入

ThinkPHP 对 MySQL 原生 JSON 字段不自动解析、不自动序列化，写入前必须 json_encode()，查询嵌套值必须用 ->> 语法或 whereRaw，否则查不到数据或报错。

为什么直接 `where('data.status', 'active')` 查不到 JSON 字段里的值

ThinkPHP 不识别 JSON 路径语法，data.status 被当成普通字段名处理，生成的 SQL 是 WHERE `data`.`status` = 'active'，而实际字段只有一个叫 data 的 JSON 列。MySQL 原生支持的是 data->>'$.status' 这种操作符。

正确写法（TP 6.0+，MySQL ≥5.7，字段类型为 json）：where('data->>status', 'active')
错误写法：where('data.status', 'active') 或 where('data->status', 'active')（后者返回带引号字符串，比较失败）
如果字段是 VARCHAR 或 TEXT，->> 会直接报错：FUNCTION database.JSON_UNQUOTE does not exist，必须先确认表结构
验证方式：SHOW COLUMNS FROM table_name LIKE 'data';，看 Type 是否为 json

`whereJsonContains` 为什么查不到数组元素

whereJsonContains 底层调用 MySQL 的 JSON_CONTAINS()，但第二个参数必须是合法 JSON 字符串（含双引号），不能是裸字符串。

Comprehensive Three.js 3D graphics reference

详细的 Three.js 3D 图形参考，涵盖场景设置、相机、几何体、材质、光照、动画、控制器、加载器、数学工具和调试。

下载

安全写法：$tag = json_encode($userInput, JSON_UNESCAPED_UNICODE); $query->whereJsonContains('tags', $tag);
危险写法：whereJsonContains('tags', 'php') → 实际执行 JSON_CONTAINS(tags, php)，MySQL 报错
路径限定更可靠：whereRaw('JSON_CONTAINS(tags, ?, "$.skills")', [$tag])，避免匹配到同名嵌套字段
注意：该方法在 MySQL

模型里怎么让 JSON 字段读取即为数组，写入自动编码

TP 6+ 支持在模型中声明 $type = ['data' => 'json']，但仅对读取生效，且要求字段类型是字符串类（TEXT 最稳妥），**不是 MySQL 原生 JSON 类型**。

读取时自动 json_decode($val, true)，但失败返回 null，务必兜底：return json_decode($value, true) ?: [];
写入时不自动 json_encode，仍需手动处理或配修改器：public function setDataAttr($value) { return json_encode($value, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES); }
别混用：原生 JSON 字段 + $type=['field'=>'json'] 会导致写入异常（TP 尝试 encode 已是 JSON 的字符串）
中文、null、斜杠易出错：没加 JSON_UNESCAPED_UNICODE 入库后是 \u4f60\u597d；没过滤 null 可能导致整个 JSON 无效

为什么加了 `->>` 还是全表扫描

MySQL 对 JSON 字段的路径查询默认无法走索引，即使语法全对，EXPLAIN 显示 type: ALL 是常态。

解法是建虚拟列 + 普通索引：ALTER TABLE table_name ADD COLUMN status VARCHAR(20) AS (data->>'$.status'); CREATE INDEX idx_status ON table_name(status);
虚拟列必须用 ->>（不能用 ->），否则值带引号，索引失效
多值数组场景（如 ["a","b"]）要用多值索引：CREATE INDEX idx_tags ON table_name((CAST(tags AS CHAR(100) ARRAY)));（MySQL 8.0.17+）
别指望 LIKE '%xxx%' 在 JSON 字段上高效——那是对原始字符串的模糊匹配，不是 JSON 查询

最常被忽略的一点：MySQL 版本、字段类型、TP 语法、索引设计这四者必须全部对齐，缺一不可；任意一个环节错位，比如字段是 TEXT 却硬写 ->>，或 MySQL 是 5.6 却信了文档说的 whereJsonContains，结果都是静默失败或报错。