使用Spatie的laravel-translatable让Eloquent模型支持多语言翻译

使用Spatie的laravel-translatable让Eloquent模型支持多语言翻译

laravel-translatableMaking Eloquent models translatable项目地址:https://gitcode.com/gh_mirrors/la/laravel-translatable

在构建全球化的Web应用时，处理多语言数据是必不可少的挑战。为了解决这个问题，Spatie提供了一个名为laravel-translatable的开源包，它允许你轻松地将Eloquent模型变为可翻译的。这个包不仅简单易用，而且不需要额外的数据表来存储翻译内容。

项目介绍

laravel-translatable是一个Laravel扩展，它包含了一个HasTranslations特性，只需将其应用到你的Eloquent模型上，即可实现模型属性的多语言管理。翻译数据以JSON格式存储在模型的一个字段中，极大地简化了数据库结构和操作。

项目技术分析

当你在模型上使用use Spatie\Translatable\HasTranslations后，你就能使用以下方法：

• setTranslation(string $key, string $locale, mixed $value)：设置特定语言环境下的翻译。
• $model->getTranslation(string $key, string $locale = null)：获取指定或当前语言环境下的翻译。
• whereLocale() 和 whereLocales()：在查询中根据语言环境筛选模型实例。

例如，创建一个新闻条目，并在英语和荷兰语环境下分别设置名称：

$newsItem = new NewsItem();
$newsItem
   ->setTranslation('name', 'en', 'Name in English')
   ->setTranslation('name', 'nl', 'Naam in het Nederlands')
   ->save();

之后，可以根据应用的当前语言环境自动返回相应的翻译：

// 在英文环境下
echo $newsItem->name; // 输出 "Name in English"

// 切换到荷兰语环境
app()->setLocale('nl');
echo $newsItem->name; // 输出 "Naam in het Nederlands"

应用场景

这个包非常适合需要多语言功能的博客、新闻系统、电子商务网站或者任何需要显示不同语言版本内容的应用。它可以用于存储文章标题、产品描述、菜单项等任何需要多种语言呈现的数据。

项目特点

• 易于集成：仅需引入trait并定义可翻译的属性。
• 无额外数据库表：翻译数据存储在模型的单一JSON字段中，降低了数据管理和维护成本。
• 灵活的查询：可以通过whereLocale()和whereLocales()直接在查询中过滤不同语言的内容。
• 动态切换语言：根据应用的当前语言环境，自动返回对应的语言版本。
• 全面的文档：提供了详尽的官方文档，方便开发者快速上手和深入学习。

为了支持Spatie的持续开发，你可以选择购买他们的付费产品。同时，如果你喜欢这个包，请考虑发送一张来自你家乡的明信片给他们，你的支持对开源社区至关重要。

获取和贡献

查看完整文档，了解更多详细信息。想要贡献力量？查看CONTRIBUTING指南。

laravel-translatable遵循MIT许可，欢迎使用。让我们共同打造更好的多语言解决方案！

探索laravel-translatable并开始你的多语言之旅!

laravel-translatableMaking Eloquent models translatable项目地址:https://gitcode.com/gh_mirrors/la/laravel-translatable