Laravel Lang 语言包仓库实战指南：为 Laravel 全家桶提供 128 种本地化翻译

后端【免费下载链接】langList of 128 languages for Laravel Framework, Laravel Jetstream, Laravel Fortify, Laravel Breeze, Laravel Cashier, Laravel Nova and Laravel UI.项目地址https://gitcode.com/gh_mirrors/la/lang点击查看免费下载Laravel Langlaravel-lang/lang是一个以数据为中心的多语言资源仓库覆盖 Laravel Framework、Jetstream、Fortify、Breeze、Cashier、Nova、Spark、UI 与 Passkeys 等全家桶组件累计提供 128 种语言、约 150K 条翻译键。本文以仓库 README.md 为主线结合 composer.json、src/Plugin.php 及locales/、source/目录的源码结构讲清楚这个包是什么、如何安装发布、资源如何组织以及如何用docs/status.md追踪各语言完成度。读完你将能独立完成语言包的引入、发布与维护。一、包是什么一个翻译数据 发布插件的复合仓库从 README.md 的标题可以看出这是一个名为Laravel Localizations的本地化资源包。与常见的翻译插件不同它本身不承载 UI 逻辑而是提供语言数据locales/locale/下每个语言目录包含json.json、json-inline.json、php.json、php-inline.json与_excludes.json五种文件发布机制通过 Composer 安装后包内注册了 ServiceProvider 和 Plugin将翻译资源按目标组件版本映射并发布到 Laravel 应用。composer.json 中明确声明require: php ^8.2、ext-json与laravel-lang/publisher ^16.0并设置了与laravel/framework 11.0.7的冲突约束说明该仓库面向 Laravel 11 的现代版本体系。从源码结构看locales/存的是翻译成品source/存的是源键值模板二者通过laravel-lang/status-generator校验一致性最终由laravel-lang/publisher完成发布——这是一个典型的数据仓库 发布工具分离设计。二、快速上手安装与发布README.md 将详细安装指引指向官方文档站但结合 composer.json 的extra.laravel.providers配置可以还原出标准安装流程# 作为开发依赖安装发布到应用的翻译通常属于构建期产物 composer require --dev laravel-lang/lang安装后 Composer 会根据extra.laravel.providers自动发现并注册LaravelLang\Lang\ServiceProvider。该 Provider 的注册逻辑非常克制见 src/ServiceProvider.phppublic function register(): void { if (class_exists(Provider::class)) { $this-app-register(Plugin::class); } }也就是说只有当laravel-lang/publisher提供的Provider基类存在时才会继续注册 Plugin。随后发布命令将按插件清单把对应语言文件复制进应用的lang/目录php artisan lang:add zh_CN # 发布中文语言包 php artisan lang:update # 同步更新所有已发布语言 php artisan lang:rm zh_CN # 移除中文语言包注意以上lang:命令由依赖的laravel-lang/publisher包提供本仓库本身只提供数据与插件定义不内置 Artisan 命令实现。三、插件清单一个 Plugin 如何覆盖全家桶src/Plugin.php 是整包的中枢它继承LaravelLang\Publisher\Plugins\Provider并在$plugins数组里注册了面向各组件及版本的分插件组件插件覆盖版本Laravel FrameworkPlugins\Laravel\Master、V11、V12、V13dev-master / ^11.0 / 12.x / 13.xJetstreamPlugins\Jetstream\Master、V5dev-master / ^5.0FortifyPlugins\Fortify\Master、V1dev-master / ^1.0BreezePlugins\Breeze\Master、V2dev-master / ^2.0Cashier (Stripe)Plugins\Cashier\Stripe\Master、V15dev-master / ^15.0NovaPlugins\Nova\V4、V5、LogViewer、DuskSuite4.x / 5.x / 附加套件SparkPlugins\Spark\Paddle、Stripe支付渠道分支UIPlugins\UI\Master、V4dev-master / ^4.0PasskeysPlugins\Passkeys\Main独立套件这种组件 版本双维拆分的插件设计让发布器能根据应用里实际安装的组件版本只发布匹配的语言文件。以 src/Plugins/Laravel/V11.php 为例它声明vendor laravel/framework、version ^11.0并返回文件映射public function files(): array { return [ framework/11.x/framework.json {locale}.json, framework/extended.json {locale}.json, framework/11.x/auth.php {locale}/auth.php, framework/11.x/pagination.php {locale}/pagination.php, framework/11.x/passwords.php {locale}/passwords.php, framework/11.x/validation.php {locale}/validation.php, ]; }{locale}占位符会在发布时替换为目标语言代码映射左侧对应source/下的模板文件右侧对应发布产物在lang/中的路径。这也印证了 source/framework 目录下11.x/、12.x/、13.x/、master/与extended.json的存在意义每个版本一套键值另有一份跨版本共享的extended.json。四、语言数据与源模板五大文件类型详解locales/下每个语言目录如 locales/zh_CN固定包含五个文件它们的定位如下文件格式内容定位json.jsonJSONLaravel 的 JSON 翻译资源{locale}.json的源供__(key)与 Vue/JS 前端使用json-inline.jsonJSONJSON 内联格式面向单行/内联场景的键值php.jsonPHP 数组面向lang/{locale}/下 PHP 语言文件的翻译键值php-inline.jsonJSON生成 PHP 内联属性翻译lang/{locale}/内联校验消息的中间数据_excludes.jsonJSON排除清单声明哪些键不需要翻译或发布这些文件是事实数据而非程序逻辑因此阅读体验近似于语言表翻译精度与覆盖率正是通过它们与source/模板的比对来度量的。例如 docs/statuses/zh_CN.md 显示中文包仅剩 7 个键未翻译其中包括array_keys、base64两个新增的 PHP 校验规则键以及 3 条加密环境文件相关的 JSON 键——这些缺口恰好反映了 Laravel 11.7 新命令与 PHP 8.3 新校验规则的演进痕迹。五、完成度追踪status 文档怎么用README.md 的徽章指向 CI 构建与 Packagist 下载量而翻译完成度则由 docs/status.md 集中呈现。该文档顶部给出总体完成度如 97.82%147.1K / 150.4K并将全部语言以网格形式链接到 docs/statuses/ 下的单语言明细页。以 docs/statuses/zh_CN.md 为例单语言页面按json、php-inline、php三类资源分别列出缺失键及缺失数量并用[go back](https://link.gitcode.com/i/6a0103c3f4e22125a1a59e5b53fc8f86)返回总览。这类文档由laravel-lang/status-generator在 CI 中自动生成属于机器可读的进度台账——贡献者在提交新翻译前可据此精确锁定待补键。六、测试与代码风格仓库自身的工程质量仓库用 PHPUnit 做冒烟验证tests/PluginTest.php 继承LaravelLang\StatusGeneratorTests\TestCase并以base_path __DIR__ . /../指回仓库根目录用于校验插件注册与文件映射的完整性。代码规范方面composer.json 的scripts定义了完整的质量流程post-update-cmd: [ codestyle pint 8.2, codestyle editorconfig, codestyle npm, composer normalize ], format: [ vendor/bin/lang sync, style ], style: vendor/bin/pint --parallel, test: vendor/bin/phpunit --colorsalways其中vendor/bin/lang sync负责把locales/与source/重新对齐同步pint --parallel执行 Laravel Pint 代码风格检查phpunit跑测试——整体体现了数据同步、风格、测试三件套的维护闭环。仓库同时提供 pint.json 与 biome.json 两份风格配置分别覆盖 PHP 与前端/JSON 工具链。七、许可证与贡献README.md 声明本包基于MIT License开源LICENSE这意味着你可以自由地在商业项目中引入、修改和再分发翻译数据。若希望回馈社区可通过官方文档站的贡献指南提交翻译贡献入口聚焦于补齐 docs/statuses/ 中标记的缺失键维护团队也接受 Boosty 等渠道的赞助支持。结语Laravel Lang 的价值不在于代码量而在于它把128 种语言 × 全家桶组件 × 多版本这一庞大矩阵组织成了可发布、可校验、可追踪的数据仓库。理解 src/Plugin.php 的插件映射、locales/的五文件结构以及docs/status.md的完成度台账你就能熟练地把它接入自己的 Laravel 项目并为中文等语言持续补齐缺失的翻译键。赞分享后端【免费下载链接】langList of 128 languages for Laravel Framework, Laravel Jetstream, Laravel Fortify, Laravel Breeze, Laravel Cashier, Laravel Nova and Laravel UI.项目地址https://gitcode.com/gh_mirrors/la/lang点击查看免费下载相关推荐Dagger TypeScript SDK FileType 枚举完全解析文件类型判定的实战指南Dagger TypeScript SDK FileType 枚举完全解析文件类型判定的实战指南 FileType 是 Dagger 0.19 TypeScr后端终极Pylearn2开发者指南如何为深度学习框架贡献代码和扩展功能终极Pylearn2开发者指南如何为深度学习框架贡献代码和扩展功能 Pylearn2是一个强大的深度学习框架虽然目前没有活跃的开发者维护但它的代码库仍然为后端VMIR函数调用完全指南外部函数解析与vmir_vm_function_call使用技巧VMIR函数调用完全指南外部函数解析与vmir_vm_function_call使用技巧 VMIRVirtual Machine for Intermedi上一篇英雄联盟Akari助手从新手到高手的3个实战进阶指南下一篇LogExpert5分钟掌握Windows平台最强大的图形化日志分析工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考