README

此包将您的 Laravel 应用中的所有本地化消息转换为 JavaScript，使用一个小型库来与这些消息交互，语法与您熟悉的语法非常相似。

功能

• 支持 Laravel 4.2, 5.0, 5.1, 5.2, 5.3, 5.4, 5.5, 6.x, 7.x 和 8.x!
• 包括 Lang.js（一个灵感来自 Laravel 的 Translator 类的精简库）。
• 允许指定要转换为 JS 的所需语言文件。
• Lang.js API 基于 Laravel 的 Translator 类。无需学习整个 API。

安装

composer require zoozoozoo/laravel-js-localization

在您的 Laravel 应用中，转到 config/app.php 并添加以下服务提供者

ZooZooZoo\LaravelJsLocalization\LaravelJsLocalizationServiceProvider::class

用法

Laravel-JS-Localization 包提供了一个命令，用于生成在 app/lang（Laravel 4）或 resources/lang（Laravel 5）目录中找到的所有消息的 JavaScript 版本。生成的 JavaScript 文件将包含您的所有消息以及 Lang.js（一个灵感来自 Laravel 的 Translator 类的精简库）。

生成 JS 消息

php artisan lang:js

指定自定义目标

php artisan lang:js public/assets/dist/lang.dist.js

压缩 JS 文件

php artisan lang:js -c

指定自定义源文件夹

php artisan lang:js public/assets/dist/lang.dist.js -s themes/default/lang

输出 JSON 文件。

php artisan lang:js --json

配置

首先，通过运行以下命令发布默认包的配置文件

php artisan vendor:publish --provider="ZooZooZoo\LaravelJsLocalization\LaravelJsLocalizationServiceProvider"

配置将发布到 config/localization-js.php。

您可以通过编辑此文件来定义您在 Javascript 代码中需要的消息。只需编辑配置文件中的 messages 数组即可。**空的 messages 数组将包括构建中所有语言文件**。

仅使 pagination.php 和 validation.php 文件包含在构建过程中

<?php

return [
    'messages' => [
        'pagination',
        'validation',
    ],
];

使用 gulp（可选）

安装 gulp-shell 并然后在您的 gulpfile.js 中直接运行它

var shell = require('gulp-shell');

gulp.task('langjs', shell.task('php artisan lang:js -c public/js/messages.js'));

使用 Laravel 的 elixir（可选）

在 Elixir 4.0 之前

elixir.extend('langjs', function(path) {
    gulp.task('langjs', function() {
        gulp.src('').pipe(shell('php artisan lang:js ' + (path || 'public/js/messages.js')));
    });

    return this.queueTask('langjs');
});

Elixir 4.0+

var Task = elixir.Task;
elixir.extend('langjs', function(path) {
    new Task('langjs', function() {
        gulp.src('').pipe(shell('php artisan lang:js ' + (path || 'public/js/messages.js')));
    });
});

使用如下方式

elixir(function(mix) {
    mix.langjs();
});

使用 Laravel 5.4+ 的 Laravel 的 Mix（可选）

将 "webpack-shell-plugin" 添加到 package.json 的 "devDependencies" 部分。

在 webpack.mix.js 中添加以下内容

const WebpackShellPlugin = require('webpack-shell-plugin');

// Add shell command plugin configured to create JavaScript language file
mix.webpackConfig({
    plugins:
    [
        new WebpackShellPlugin({onBuildStart:['php artisan lang:js --quiet'], onBuildEnd:[]})
    ]
});

文档

这是关于 Lang.js（由 Laravel-JS-Localization 包包含的精简 JavaScript 库）的简要文档。Lang.js（一个灵感来自 Laravel 的 Translator 类的精简库）。

💁 前往 Lang.js 文档以查看所有可用方法。

获取消息

Lang.get('messages.home');

带有替换的获取消息

Lang.get('messages.welcome', { name: 'Joe' });

更改区域设置

Lang.setLocale('es');

检查消息键是否存在

Lang.has('messages.foo');

根据数量支持单数和复数消息

Lang.choice('messages.apples', 10);

调用带替换的 choice 方法

Lang.choice('messages.apples', 10, { name: 'Joe' });

💁 前往 Lang.js 文档以查看所有可用方法。

想要贡献吗？

1. 从这个仓库分叉并克隆它。
2. 从 develop 分支创建一个 功能分支： git checkout develop; git checkout -b feature-foo。
3. 推送您的提交并创建一个拉取请求。

先决条件

您需要安装以下软件。

• Composer。
• PHP 5.5+。

开发设置

获取所有所需的软件后，您可以运行以下命令来准备一切

1. 安装 PHP 依赖

   composer install

2. 安装测试依赖

   composer test-install

现在您可以开始了！祝您编码愉快！

测试

此项目使用 PHPUnit。所有测试都存储在 tests 目录中。要在终端运行所有测试，请输入

composer test

由 Rubens Mariuzzo 使用 ❤️ 制作。

MIT 协议