mjahn / language
Laravel 的语言切换包。
Requires
- php: >=5.6.4
- consoletvs/identify: 1.*
- laravel/framework: >=5.4.0|^6.0
README
此包允许在 Laravel 项目中轻松切换区域设置。使用非常简单,安装后,只需将路由传递到 SetLanguage 中间件,应用程序的区域设置就会更改。
主要功能
- 根据用户浏览器配置自动更改应用程序区域设置
- 内置语言标志,易于实现
- 从代码如“en”或“es”中获取语言名称,如“English”或“Español”
- 可以选择短(en)或长(en-GB)语言代码
- 将区域设置存储在用户表中
- 限制用户设置您没有翻译的语言
- 为清洁、简单且易于阅读的 API 提供辅助函数
- 支持 Carbon 和 Date 包
入门指南
1. 安装
运行以下命令
composer require akaunting/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
中间件下,以便在每个请求中设置应用程序的区域设置。
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,则返回 $code
的语言名称;如果没有指定,则返回当前设置的语言。
提示: 使用 app()->getLocale() 获取当前区域设置
language()->getCode($name = 'default')
如果指定了 $name
,则返回其语言代码,否则返回当前设置的语言。
变更日志
有关最近更改的更多信息,请参阅发行版。
贡献
有关详细信息,请参阅贡献指南。
安全性
如果您发现任何与安全相关的问题,请通过电子邮件 security@akaunting.com 而不是使用问题跟踪器来报告。
鸣谢
许可证
MIT许可证(MIT)。有关更多信息,请参阅许可证。