LaravelEloquent属性本地化教程

Laravel Eloquent 本身不提供开箱即用的多语言字段支持，所谓“本地化”实则是通过严格的字段命名约定（如 title_zh、title_en）、在 accessor 中手动拼接 locale 并实现显式 fallback 逻辑来模拟；API 返回需主动声明 $appends 或借助 JsonResource 显式赋值，否则计算属性不会出现在 JSON 中；写入则必须明确指定具体语言字段或封装安全的批量更新方法，绝不能依赖 locale 自动路由写入——因为 Eloquent 从不维护“本地化状态”，所有多语言行为都需开发者亲手把控字段一致性、数据库索引、collation 及写入入口，稍有松懈就会导致数据混乱、搜索失效或语言错乱。

“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 不支持“一个属性写多个字段”，必须明确指定目标。

• 不要重载 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 自动兜底所有场景。

以上就是《LaravelEloquent属性本地化教程》的详细内容，更多关于的资料请关注golang学习网公众号！