Looking to hire Laravel developers? Try LaraJobs

translation-laravel-sdk maintained by carlin

Description
Laravel SDK for translation collection and package sync
Last update
2026/03/27 11:45 (v1.0.0.x-dev)
License
MIT
Links
GitHub - Packagist
Downloads
2

v1.0.0.x-dev

Last update
2026/03/27 11:45
License
MIT
Require
  • php ^8.2
  • guzzlehttp/guzzle ^7.0
  • illuminate/cache ^8.83|^9.0|^10.0
  • illuminate/console ^8.83|^9.0|^10.0
  • illuminate/http ^8.83|^9.0|^10.0
  • illuminate/redis ^8.83|^9.0|^10.0
  • illuminate/support ^8.83|^9.0|^10.0
  • illuminate/translation ^8.83|^9.0|^10.0
v1.0.1

Last update
2026/03/27 11:45
License
MIT
Require
  • php ^8.2
  • guzzlehttp/guzzle ^7.0
  • illuminate/cache ^8.83|^9.0|^10.0
  • illuminate/console ^8.83|^9.0|^10.0
  • illuminate/http ^8.83|^9.0|^10.0
  • illuminate/redis ^8.83|^9.0|^10.0
  • illuminate/support ^8.83|^9.0|^10.0
  • illuminate/translation ^8.83|^9.0|^10.0
dev-master

Last update
2026/03/27 11:31
License
MIT
Require
  • guzzlehttp/guzzle ^7.0
  • php ^8.4
  • illuminate/cache ^12.0
  • illuminate/console ^12.0
  • illuminate/http ^12.0
  • illuminate/redis ^12.0
  • illuminate/support ^12.0
  • illuminate/translation ^12.0
v2.0.0.x-dev

Last update
2026/03/27 11:31
License
MIT
Require
  • guzzlehttp/guzzle ^7.0
  • php ^8.4
  • illuminate/cache ^12.0
  • illuminate/console ^12.0
  • illuminate/http ^12.0
  • illuminate/redis ^12.0
  • illuminate/support ^12.0
  • illuminate/translation ^12.0
v2.0.0

Last update
2026/03/27 11:31
License
MIT
Require
  • php ^8.4
  • guzzlehttp/guzzle ^7.0
  • illuminate/cache ^12.0
  • illuminate/console ^12.0
  • illuminate/http ^12.0
  • illuminate/redis ^12.0
  • illuminate/support ^12.0
  • illuminate/translation ^12.0
v1.0.0

Last update
2026/03/27 09:47
License
MIT
Require
  • php ^8.2
  • guzzlehttp/guzzle ^7.0
  • illuminate/cache ^8.83|^9.0|^10.0|^11.0|^12.0
  • illuminate/console ^8.83|^9.0|^10.0|^11.0|^12.0
  • illuminate/http ^8.83|^9.0|^10.0|^11.0|^12.0
  • illuminate/redis ^8.83|^9.0|^10.0|^11.0|^12.0
  • illuminate/support ^8.83|^9.0|^10.0|^11.0|^12.0
  • illuminate/translation ^8.83|^9.0|^10.0|^11.0|^12.0
Comments
comments powered by Disqus

translation-laravel-sdk

Laravel 翻译 SDK，支持以下能力：

  • 主动采集：扫描代码中的翻译 key / 文本并批量上报
  • 被动采集：运行时 miss 进入缓冲区并按批次 flush
  • 翻译包同步：按 locale + cursor 增量拉取并写入本地缓存

安装

  1. 通过 Composer 引入包
  2. 发布配置：
php artisan vendor:publish --tag=translation-sdk-config

命令

  • php artisan translation-sdk:collect-active
  • php artisan translation-sdk:flush-missing
  • php artisan translation-sdk:sync-package

sync-package 默认行为：

  • 自动从网关读取目标 locale（/interact/translation/sync-targets）
  • 按 locale 持久化 cursor 做增量同步
  • --full 从 cursor 0 全量拉取
  • --cursor 可一次性覆盖起始 cursor（调试用，不写回持久 cursor）

运行时翻译

支持 Laravel 原生入口：

__('validation.required');
trans('order.status.pending');
trans_choice('order.items', 3);

运行时流程：

  • 先查 Laravel 本地 lang
  • 未命中时查 SDK 同步缓存
  • 仍未命中则上报被动采集并返回原始 key（保持 Laravel 行为）

测试

composer install
composer test