Laravel 语言切换器包——akaunting/laravel-language

1. 项目介绍

akaunting/laravel-language 是一个为 Laravel 框架设计的语言切换器包。它允许开发者轻松地在 Laravel 项目中切换语言。一旦安装，只需要通过路由传递到 SetLanguage 中间件，应用程序的语言就会相应改变。该包具有以下特点：

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

2. 项目快速启动

首先，通过以下命令安装包：

composer require akaunting/laravel-language

对于 Laravel 5.5 以下版本，需要在 config/app.php 文件中注册服务提供者和（可选的）别名：

'providers' => [
    // ...
    Akaunting\Language\Provider::class,
],

'aliases' => [
    // ...
    'Language' => Akaunting\Language\Facade::class,
],

接下来，发布配置、迁移和 Blade 文件：

php artisan vendor:publish --tag=language

执行迁移来添加地区列到用户表：

php artisan migrate

最后，可以在 config/language.php 中修改默认值。

3. 应用案例和最佳实践

• 中间件使用：确保所有需要设置语言的路线都位于 language 中间件下：

Route::group([
    'middleware' => 'language',
], function () {
    // 在这里定义你的路由
});

• URL 语言切换：使用以下 URL 结构来切换语言并返回主页或返回上一页：

/languages/{locale}/home
/languages/{locale}/back

• ** Blade 模板**：在 Blade 视图中使用以下方法来显示语言标志或获取语言名称：

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

• 辅助函数：使用 language() 函数来获取当前语言信息或切换语言：

language()->getName(); // 获取当前语言名称
language()->getCode(); // 获取当前语言代码

4. 典型生态项目

目前，akaunting/laravel-language 项目作为一个独立包，没有列出特定的生态项目。但是，它通常与任何需要多语言支持的 Laravel 应用程序一起使用，特别是在需要用户界面本地化的企业级应用中。此外，开发者可以根据需要为该包创建扩展或插件，以进一步扩展其功能。