PHP怎么处理Eloquent Attribute Locales属性区域设置_Laravel本地化数据上下文【方法】-php教程-PHP中文网

$model->getAttribute('name') 不返回当前 locale 值，因该方法直接读取原始字段（如 JSON 字符串或数组），不执行 locale 切换逻辑；需通过 accessor（如 getTitleAttribute）显式提取 $this->attributes['name'][$locale] 并设 fallback。

php怎么处理eloquent attribute locales属性区域设置_laravel本地化数据上下文【方法】

为什么 `$model->getAttribute('name')` 在多语言场景下不返回当前 locale 的值

因为 Eloquent 默认不感知 locale，getAttribute() 拿的是原始字段值（比如 JSON 字符串或带 locale 键的数组），不是自动翻译后的结果。你看到的 "name" 可能是 {"en": "Apple", "zh": "苹果"}，而不是当前 app()->getLocale() 对应的 "苹果"。

常见错误现象：前端调用 $post->title 显示整段 JSON；或者手动写 $post->title[app()->getLocale()] 但没做空值判断，导致 Undefined array key 报错。

必须显式定义访问器（accessor）来封装 locale 切换逻辑
避免在模型外重复写 [app()->getLocale()]，否则 locale 变更后容易漏改
如果字段是数据库 JSON 类型，需配合 $casts = ['name' => 'array']，否则取出来是字符串，无法直接下标访问

怎么用 `getAttribute` + `getTranslatedAttribute` 统一处理本地化字段

不要覆盖 getAttribute() 全局行为（会破坏 Eloquent 内部逻辑），而是针对具体字段加 accessor。例如字段名是 title_translations，对应多语言内容：

protected $casts = [
    'title_translations' => 'array',
];

public function getTitleAttribute()
{
    $locale = app()->getLocale();
    $translations = $this->attributes['title_translations'] ?? [];

    return $translations[$locale] ?? ($translations['en'] ?? '');
}

这样 $post->title 就自动返回当前 locale 的值，fallback 到 en，再 fallback 到空字符串。

务必检查 $this->attributes 而非 $this->title_translations，避免触发 getter 递归调用
如果用的是 Laravel 9+ 和 MySQL JSON 字段，cast 必须设为 'array'，不能是 'json'（后者返回 stdClass）
若 locale 是动态传入（如 API 请求头指定），建议把 locale 提取为参数，而不是硬绑 app()->getLocale()

如何让 `toArray()` 和 API 响应也自动本地化

toArray() 默认不会走 accessor，所以即使写了 getTitleAttribute()，$post->toArray()['title'] 还是原始 JSON。要修复它，得重写 toArray() 或用 $appends：

Laravel Cloud

Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。

下载

protected $appends = ['title'];

// 然后确保 getTitleAttribute() 已定义（见上一节）
// 这样 toArray()、toJson()、API Resource 都会包含本地化后的 title

但注意：$appends 会让字段始终存在，哪怕数据库里是 null —— 如果你希望只在有翻译时才输出，就得在 accessor 里控制返回 null，并配合 hidden 或 Resource 中的条件逻辑。

别在 $appends 里加未定义 accessor 的字段，会报 Call to undefined method
如果字段需要支持编辑（比如 Form Request 提交），记得同时写 setTitleAttribute()，把单语言值存进对应 locale 键
使用 ApiResource 时，优先在 Resource 的 toArray() 里做翻译，比模型层更灵活（比如不同接口用不同 fallback 策略）

为什么 `where('title_translations->en', 'Apple')` 查询失败

MySQL JSON 查询语法敏感：Laravel 的 where() 不会自动加引号，->en 实际生成 SQL 是 title_translations->'$.en'（注意单引号）。但如果你写成 ->en，MySQL 会当成列名解析，报错 Unknown column 'en'。

正确写法必须用字符串形式，并注意 JSON 路径语法：

// ✅ 正确
Post::where('title_translations->$.en', 'Apple')->get();

// ❌ 错误（少 $.）
Post::where('title_translations->en', 'Apple')->get();

// ✅ 更安全：用 whereJsonContains（Laravel 8.76+）
Post::whereJsonContains('title_translations', ['en' => 'Apple'])->get();