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

提示： /languages 前缀可以通过 config/language.php 修改

方法

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，则返回该语言的名称；如果没有指定，则返回当前设置的语言。

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

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

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

变更日志

请参阅发行版以获取有关最近更改的更多信息。

贡献

欢迎提交拉取请求。您必须遵循PSR编码标准。

安全

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

鸣谢

许可证

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

akaunting / language

维护者

详细信息