Eloquent 不支持自动多语言字段,需通过命名约定(如 title_zh)、accessor 动态拼接 locale、显式 fallback 机制实现;API 返回需声明 $appends 或用 JsonResource 显式赋值,写入必须明确指定字段或封装方法。

“Localization States”不是 Laravel 的标准概念,Eloquent 本身不维护“本地化状态”,它只负责读写字段;所谓多语言字段支持,本质是用 accessor 动态拼接字段名 + 显式控制写入路径,所有逻辑都得你手动写清楚。
怎么让 getTitleAttribute() 正确返回当前语言的值
核心是字段命名约定 + locale 拼接 + fallback 机制。不能靠 $casts 或自动映射,必须在 accessor 里显式判断。
-
app()->getLocale()获取当前语言(如'en'、'zh'),但要先确认中间件已设置好,否则可能返回'en'硬编码值 - 字段名必须按
title_en、title_zh这种格式存,不能用 JSON 字段假装“支持多语言”——查不出索引、没法加 collation、搜索失效 - fallback 要写实:先查
$this->{'title_'.$locale},为空或 null 时再查$this->{'title_'.config('app.fallback_locale')},别只 return '' - 避免在 accessor 里调
__()或trans()——那是翻译静态文案的,数据库字段内容不该被二次翻译
为什么 API 返回里看不到 title,但 Blade 模板里能显示
因为 Eloquent 的 toArray() 默认不包含 accessor 计算值,除非你告诉它这个字段需要附加。
- 必须在模型中声明
protected $appends = ['title', 'content'];,否则 JSON 输出永远只有原始字段(如title_zh) - 如果用了
JsonResource,可以直接在toArray()里写'title' => $this->title,这时$appends不生效也没关系 - 别把
title加进$casts,比如'title' => 'string'——数据库没这个字段,会报Column not found
写入多语言字段时最常踩的三个坑
读可以代理,写不能偷懒。Eloquent 不支持“一个属性写多个字段”,必须明确指定目标。
立即学习“PHP免费学习笔记(深入)”;
- 不要重载
setTitleAttribute()并在里面根据 locale 自动写title_zh或title_en——后台管理员用中文界面编辑英文内容时,会误覆写title_zh - 写入一律走具体字段:
$post->title_zh = '你好'; $post->title_en = 'Hello'; $post->save(); - 如需封装,写独立方法:
public function updateTitle(array $titles): void { foreach ($titles as $locale => $value) { $field = 'title_'.$locale; $this->{$field} = $value; } },调用时传['zh' => '你好', 'en' => 'Hello']
真正麻烦的不是读取逻辑,而是字段命名一致性、索引覆盖、collation 设置和写入入口的收敛——这些地方一松动,多语言数据就不可靠。别指望 accessor 自动兜底所有场景。



















