README

一个软件包，用于启用使用翻译服务而不是本地文件。

📝 简介

在 Nodes，我们创建了许多内容，需要支持多种语言。开箱即用的翻译功能需要开发者在本地文件中进行更改，并提交和部署。但我们需要使用一种服务，让其他人（客户、项目经理等）能够管理翻译。

此软件包使得在您的 Laravel 应用程序中创建翻译提供者和通用使用变得容易。

目前它仅支持

• NStack

但我们非常欢迎提供其他服务提供者的拉取请求。

📦 安装

要安装此软件包，您需要

• Laravel 5.1+
• PHP 5.5.9+

然后您必须修改您的 composer.json 文件并运行 composer update 以将软件包的最新版本包含到您的项目中。

"require": {
    "nodes/translate": "^1.0"
}

或者您可以从终端运行 composer require 命令。

composer require nodes/translate:^1.0

🔧 配置

在 Laravel 5.5 及更高版本中，服务提供者和别名将自动注册。如果您使用的是 Laravel 5.5 或更高版本，请直接跳转到 发布配置文件。

在 config/app.php 中设置服务提供者

Nodes\Translate\ServiceProvider::class

在 config/app.php 中设置别名

'Translate' => Nodes\Translate\Support\Facades\Translate::class

发布配置文件

php artisan vendor:publish --provider="Nodes\Translate\ServiceProvider"

如果您想覆盖任何现有的配置文件，请使用 --force 参数

php artisan vendor:publish --provider="Nodes\Translate\ServiceProvider" --force

⚙ 使用方法

全局方法

translate($key, $replacements = [], $locale = null, $platform = null)

translate_app($app, $key, $replacements = [], $locale = null, $platform = null)

translate_or_fail($key, array $replacements = [], $locale = null, $platform = null)

translate_app_or_fail($application, $key, $replacements = [], $locale = null, $platform = null)

translate_with_fallback($key, $fallback, array $replacements = [], $locale = null, $platform = null)

translate_app_with_fallback($application, $key, $fallback, $replacements = [], $locale = null, $platform = null)

回退

处理回退有两种方式，如果键不存在或 NStack 不可用且缓存无效

1. 默认情况下，translate() 函数将使用 laravel 的 trans('nstack.' . key) 作为回退，这意味着您可以将 nstack 键下载下来，将它们重新格式化为 php 数组，并将其插入到 /ressources/lang/en/nstack.php 文件中

2. 使用 translate_with_fallback 并决定使用什么

🏆 致谢

此软件包由 Nodes 的 PHP 团队开发和维护

📄 许可证

此软件包是开源软件，许可协议为 MIT 许可证