README

此包允许在 Laravel 项目中轻松切换地区。使用起来非常简单，安装后，您的应用程序地区将仅通过传递路由到 SetLanguage 中间件而更改。

主要特性

根据用户浏览器配置自动更改应用程序地区
内置语言标志，易于实现
从代码如 'en' 或 'es' 获取语言名称，如 'English' 或 'Español'
可选择短（en）或长（en-GB）语言代码
在用户表中存储地区
限制用户设置您没有翻译的语言
辅助函数用于清洁、简单且易于阅读的 API
支持 Carbon 和 Date 包

入门指南

1. 安装

运行以下命令

composer require akaunting/laravel-language

2. 注册（对于 Laravel < 5.5）

在 config/app.php 中注册服务提供者

Akaunting\Language\Provider::class,

如果您想使用外观，请添加别名。

'Language'   => Akaunting\Language\Facade::class,

3. 发布

发布配置、迁移和 blade 文件。

php artisan vendor:publish --tag=language

4. 迁移

向用户表添加地区列

php artisan migrate

5. 配置

默认值也可以在 config/language.php 中修改

键

route: 使路由可用
carbon: 设置 briannesbitt/carbon 翻译器语言
date: 设置 jenssegers/date 翻译器语言
home: 使主页路由可用
auto: 根据用户浏览器配置自动设置语言
prefix: 设置地区路由 URI 的前缀
middleware: 默认中间件来设置地区
controller: 默认控制器来处理地区
flags: 标志的设置，如宽度、类等
mode: 语言代码和名称模式
allowed: 允许的语言代码
all: 可用的语言名称和代码

用法

中间件

您想设置语言的所有路由都应该在 language 中间件下，以便在每个请求中设置 App 地区。

Route::group(['middleware' => 'language'], function () {

    // Here your routes

});

URL

通过 URL 返回主页：/languages/{locale}/home
通过 URL 返回上一个页面：/languages/{locale}/back

提示： 从 config/language.php 可以更改 /languages 前缀

方法

language()->allowed()

返回一个包含所有配置中允许的语言的 [$code => $name] 数组。示例用法在 blade 中

@foreach (language()->allowed() as $code => $name)
    <a href="{{ language()->back($code) }}">{{ $name }}</a>
@endforeach

language()->flags()

返回一个包含所有配置中允许的语言的标志输出。输出可以更改从 resources/views/vendor/language 文件夹

language()->flag()

返回当前地区的标志。输出可以更改从 resources/views/vendor/language 文件夹

language()->names($codes = null)

从一个仅包含 $codes 的数组中获取一个类似 [$code => $name] 的数组。

language()->codes($langs = null)

从一个仅包含 $langs 的数组中获取一个类似 [$name => $code] 的数组。

language()->back($code)

返回设置语言并返回的 URL：back()

如果您更喜欢直接使用 route() 函数，可以按以下代码使用它

{{ route('language::back', ['locale' => $code]) }}

language()->home($code)

返回设置语言并返回主页的 URL：url('/')

如果您更喜欢直接使用 route() 函数，可以按以下代码使用它

{{ route('language::home', ['locale' => $code]) }}

language()->getName($code = 'default')

如果指定了 $code，则返回 $code 的语言名称，如果没有指定，则返回当前设置的语言。

提示： 使用 app()->getLocale() 获取当前地区

language()->getCode($name = 'default')

如果指定了 $name，则返回其语言代码；如果没有指定，则返回当前设置的语言。

变更日志

请参阅发布记录了解最近更改的详细信息。

贡献

我们非常欢迎拉取请求。您必须遵循PSR编码标准。

安全性

如果您发现任何与安全相关的问题，请通过电子邮件发送到 security@akaunting.com，而不是使用问题跟踪器。

致谢

许可协议

MIT 许可协议（MIT）。有关更多信息，请参阅 LICENSE。

akaunting / laravel-language

维护者

详细信息