ThinkPHP多语言JSON字段怎么用_ThinkPHP多语言数据存储技巧【汇总】-ThinkPHP-PHP中文网

thinkphp 的 json 字段不支持多语言，需自行设计结构（如平铺式或对象式），确保字段为 json 类型、mysql≥5.7，并手动处理键名访问、解析容错与语言 fallback。

thinkphp多语言json字段怎么用_thinkphp多语言数据存储技巧【汇总】

$json 字段本身不支持多语言，所谓“多语言 JSON 字段”其实是把不同语言的内容按结构存进同一个 JSON 字段里，ThinkPHP 没有内置的多语言 JSON 处理逻辑，全靠你自己设计字段结构 + 控制读写行为。

`protected $json = ['lang_data']` 是基础，但结构得自己定

ThinkPHP 的 $json 属性只负责「把字段字符串自动 json_decode 成对象/数组」，它不管里面存的是中文、英文还是带 locale 键的嵌套结构。

常见可行结构有两种：

平铺式：{"zh-CN":"你好","en-US":"Hello","ja-JP":"こんにちは"}
对象式：{"title":{"zh-CN":"标题","en-US":"Title"},"content":{"zh-CN":"正文内容"}}

无论选哪种，都必须：

写入前确保是合法 JSON（用 json_encode($data, JSON_THROW_ON_ERROR) 校验）
数据库字段类型要是 JSON（MySQL 5.7+）或至少是 TEXT，不能是 VARCHAR(255) 这种长度不够的
查询时别依赖 where('lang_data', 'like', '%Hello%') —— 这种模糊匹配不可靠，且无法利用索引

`where('lang_data->en-US', 'Hello')` 要求 MySQL 版本和字段类型双满足

这个语法本质是 MySQL 原生的 JSON_EXTRACT(lang_data, '$."en-US"')，所以：

必须用 MySQL 5.7 或更高版本
lang_data 字段类型必须是 JSON，不是 TEXT —— 否则会报错 Invalid JSON text
键名含短横线（如 en-US）必须用双引号包裹路径：lang_data->"$.\"en-US\""，ThinkPHP 的查询构造器会自动处理引号，但你要写成 where('lang_data->en-US', 'Hello') 才能被正确转义

如果字段是 TEXT 类型，只能退回到 whereRaw：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

whereRaw("JSON_CONTAINS(lang_data, '\"Hello\"', '$.\"en-US\"')")

或者更稳妥地：先查出整条记录，再在 PHP 层解析判断。

`$model->lang_data->{"en-US"}` 访问带特殊字符的键要加花括号

模型自动解码后，$model->lang_data 是 stdClass 对象。但 PHP 对象属性名不支持短横线、点号等，直接写 $model->lang_data->en-US 会语法错误。

必须用花括号 + 字符串方式访问：

$model->lang_data->{'en-US'}
或转成数组后用下标：json_decode($model->lang_data, true)['en-US']

如果你经常要读多语言字段，建议在模型里加个访问器：

public function getLangDataAttr($value)
{
    $data = json_decode($value, true) ?: [];
    return array_merge(['zh-CN' => ''], $data);
}

这样即使数据库里是 null 或空字符串，也不会导致 Notice: Trying to get property 'zh-CN' of non-object。

ThinkPHP 不会替你决定「哪条是当前语言」，也不会自动 fallback 到默认语言。这些逻辑必须自己控制——比如根据请求头 Accept-Language 拿 key，再从 JSON 字段里取值。最容易被忽略的是：字段为空、JSON 解析失败、MySQL 版本不匹配这三者混在一起时，错误表现几乎一样（都是返回 null 或空），得逐层打日志确认。