mjahn/language

Laravel 的语言切换包。

1.0.12 2019-09-04 23:02 UTC

This package is auto-updated.

Last update: 2024-09-29 05:29:49 UTC


README

Version Downloads StyleCI Quality License

此包允许在 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)。有关更多信息,请参阅许可证