Laravel 从 JSON 字段中获取特定值的最佳实践

## 只读 Laravel 模型属性：获取 JSON 字段特定值的最佳实践

简介

在 Laravel 中，模型属性通常用于存储各种数据类型，包括 JSON 对象。有时，你需要从 JSON 字段中提取特定值，例如仅获取不同语言的标题。本文将探讨使用只读属性访问器和自定义 JSON 转换器在 Laravel 中获取 JSON 字段特定值的最佳实践。

## 只读属性访问器

Laravel 提供只读属性访问器，让你能够定义一个仅用于获取属性的方法。这是一种实现只读转换的优雅方法，因为访问器只能读取属性，而不能设置它。

以下是使用只读属性访问器获取 JSON 字段中特定语言标题的示例：

protected function title(): Attribute
{
    return Attribute::make(
        get: fn ($value) => $value['en'],
    );
}

在此示例中，title 属性访问器从 JSON 字段中提取英语标题 (en)。当访问 $model->title 时，将返回英语标题。

## 自定义 JSON 转换器

自定义 JSON 转换器提供了另一种定义将 JSON 数据转换为所需格式的方法。你可以创建一个自定义转换器类，并在其中实现一个获取方法，该方法从 JSON 数据中提取特定值。

以下是如何创建一个自定义 JSON 转换器：

class LanguageSpecificJsonCast
{
    public function get($model, string $key, $value, array $attributes)
    {
        $data = json_decode($value, true);
        return $data[$key] ?? null;
    }
}

然后，你可以将自定义 JSON 转换器应用于模型属性：

protected $casts = [
    'title' => LanguageSpecificJsonCast::class . ':en',
];

在上面的示例中，en 参数指定要从 JSON 数据中获取的语言键。

## 注意事项

使用只读属性访问器或自定义 JSON 转换器时，需要注意以下几点：

• 确保模型属性的类型与要获取的值的类型匹配。
• 如果要获取的值不存在于 JSON 数据中，则返回 null。
• 可以使用 isset($model->title) 检查是否存在该值。

## 结论

使用只读属性访问器或自定义 JSON 转换器，你可以轻松地从 Laravel 模型属性中获取 JSON 字段的特定值。这可以简化数据检索并提高应用程序的性能。

## 常见问题解答

1. 我可以在模型类之外定义只读属性访问器吗？

   • 不，只读属性访问器必须在模型类中定义。

2. 我可以将自定义 JSON 转换器应用于多个属性吗？

   • 是，你可以将自定义 JSON 转换器应用于任意数量的属性。

3. 是否可以动态获取 JSON 字段的特定值？

   • 是，你可以使用 $model->{$attributeKey} 语法动态获取 JSON 字段的特定值。

4. 如何处理嵌套 JSON 数据？

   • 自定义 JSON 转换器可以处理嵌套 JSON 数据，你可以使用点语法访问嵌套值。

5. 在什么时候使用只读属性访问器而不是自定义 JSON 转换器？

   • 当只需要从 JSON 字段中提取单个值时，使用只读属性访问器更简单。当你需要从 JSON 数据中提取多个值或执行更复杂的操作时，自定义 JSON 转换器更适合。