README

此包允许在Laravel项目中轻松切换区域设置。它非常简单易用，一旦安装，只需通过将路由传递给SetLanguage中间件，应用程序的区域设置就会改变。

主要功能

根据用户浏览器配置自动更改应用程序区域设置
内置语言标志，易于实现
从代码“en”或“es”等中获取语言名称“英语”或“西班牙语”
可以选择短（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。

agenter-labs / laravel-language

维护者

详细信息