包简介

Use multiple JSON files per locale on Laravel

README 文档

README

This package is built on top of PHP JSON tongue to enable the usage of multiple JSON files per locale on Laravel.

Introduction

Starting with Laravel docs:

Translation strings may be defined within JSON files that are placed within the lang directory. When taking this approach, each language supported by your application would have a corresponding JSON file within this directory. This approach is recommended for applications that have a large number of translatable strings.

Installation

Install the package via composer:

composer require elaborate-code/laravel-json-tongue

Requirements

PHP 8.0 or higher.

Usage

File structure example:

The JSON files can co-exist with the PHP files without any conflicts!

The merge command

This command loads all the JSON files from /<locale> folders within the /lang folder and merge them per locale in new JSON files.

php artisan json-tongue:merge

Options:

Option	Description
`-F\|--force`	Removes JSON files that already exist in the root of the `lang` folder without asking

JSON files that already exist in the root of the lang folder, can be old JSON files previously generated by the command, or files that you have created manually and populated manually.

⚠️ In the second case be careful before instructing the command to remove existing JSON files!

Example

Before merging :

 lang
 ┣ 📂es
 ┃ ┣ 📜animals.json
 ┃ ┣ 📜greetings.json
 ┃ ┗ 📜jobs.json
 ┗ 📂fr
   ┣ 📜animals.json
   ┣ 📜greetings.json
   ┗ 📜jobs.json

After merging:

 lang
 ┣ 📂es
 ┃ ┣ 📜animals.json
 ┃ ┣ 📜greetings.json
 ┃ ┗ 📜jobs.json
 ┣ 📂fr
 ┃ ┣ 📜animals.json
 ┃ ┣ 📜greetings.json
 ┃ ┗ 📜jobs.json
 ┣ 📜es.json  ⭐ Usable by Laravel
 ┗ 📜fr.json  ⭐ Usable by Laravel

Testing

./vendor/bin/pest

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Help needed to add a watch command that refreshes the output JSON files with new translations added on the locale folders.

Credits

License

The MIT License (MIT). Please see License File for more information.

elaborate-code/laravel-json-tongue 适用场景与选型建议

elaborate-code/laravel-json-tongue 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 9 次下载、GitHub Stars 达 1，最近一次更新时间为 2022 年 10 月 08 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「laravel」「localization」「elaborate-code」「laravel-json-tongue」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 elaborate-code/laravel-json-tongue 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 elaborate-code/laravel-json-tongue 我们能提供哪些服务？

定制开发 / 二次开发

基于 elaborate-code/laravel-json-tongue 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

与 elaborate-code/laravel-json-tongue 相关的其它包

同方向 / 同关键字的高下载量 PHP Composer 包推荐，方便对比选型：

awes-io/localization-helper 35

Package for convenient work with Laravel's localization features

atk14/localized-decimal-field 0

Field for number with restricted count of digits and decimal places

justraviga/laravel-deepl 2

Deepl Automated translations for Laravel lang files

bureaupartners/laravel-gettext 0

Adds localization support to laravel applications in an easy way using Poedit and GNU gettext.

foxtes/alfabank-rest 1

Alfabank REST API integration

spimpolari/laravel-langman 0

Manage language files with ease.

elaborate-code/laravel-json-tongue

包简介

关键字：