后端【免费下载链接】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-Lang / lang 仓库贡献代码或翻译的开发者系统讲解该仓库的运行时要求、安装与自动加载机制、Pint/Biome 代码风格工具链、PHPUnit 测试套件运行方式以及从locales/en英文原文出发、经由docs/statuses状态文件驱动的完整翻译工作流。读完本文你将能够独立完成环境配置、编写并运行测试、执行 locale 同步以及按规范提交一份完整且通过状态校验的本地化翻译。仓库定位与整体结构Laravel-Lang / lang 是一个为 Laravel 框架及其官方一揽子组件Laravel Framework、Jetstream、Fortify、Breeze、Cashier、Nova、Spark、UI 等提供并维护多语言资源language resources的包。其核心产出是locales/目录下按语言代码组织的翻译产物而source/目录保存用于生成/更新这些产物的数据源自动化由 laravel-lang/publisher 及配套工具负责见 composer.json 中require的laravel-lang/publisher。仓库顶层目录分工如下src/—— 包运行时代码包括 ServiceProvider 及运行时辅助逻辑source/—— 生成翻译文件用的数据源在理解生成管线前不要直接编辑生成产物locales/—— 按语言维护的翻译产物如php-inline.json、json.json、_excludes.json部分文件由机器维护应通过 sync 工具更新tests/—— 测试套件目前包含依赖 status-generator 基础测试类的PluginTestdocs/—— 附加的项目/用户文档其中docs/statuses/存放每个语言代码的翻译状态报告。在src/Plugin.php中插件通过继承LaravelLang\Publisher\Plugins\Provider声明了面向各组件Breeze、Cashier/Stripe、Fortify、Jetstream、Laravel、Nova、Passkeys、Spark、UI的 Master/版本化子插件列表例如Plugins\Laravel\Master与Plugins\Laravel\V11/V12/V13这些子插件定义了源文件到目标语言文件如framework/master/framework.json→{locale}.json的映射规则见 src/Plugins/Laravel/Master.php。构建环境与安装运行时要求PHP^8.2。测试套件使用 PHPUnit^11.0 || ^12.0见 composer.json 的require-dev。低于 8.2 的 PHP 不受支持这一点在 composer.json 的require段有硬性约束。PHP 扩展ext-json。Composer 2.x。Node.js 为可选仅当需要执行 BiomeJSON/JS 格式化以及 npm 相关的代码风格任务时才需要。安装步骤按常规方式安装 PHP 与 Composer 后在仓库根目录执行composer install仓库自带composer.lock若在 CI/CD 中希望加速安装可附加--prefer-dist。若你打算在本地运行测试请务必使用完整的composer install不要加--no-dev因为测试套件依赖 dev 依赖laravel-lang/status-generator提供的基础测试类。自动加载与 Laravel 集成生产代码PSR-4 自动加载命名空间LaravelLang\Lang\映射到src/见 composer.json 的autoload段。测试代码PSR-4 dev 自动加载命名空间Tests\映射到tests/autoload-dev段。Laravel 集成包在extra.laravel.providers中声明了LaravelLang\Lang\ServiceProvider从而允许 Laravel 应用自动发现。该 ServiceProvider 在register()中检测LaravelLang\Publisher\Plugins\Provider类是否存在存在时再注册Plugin见 src/ServiceProvider.php保证了与发布器组件的解耦。工具链与代码风格Composer 脚本仓库在 composer.json 的scripts段定义了如下脚本composer run format—— 依次执行vendor/bin/lang sync和style即 Pint。从数据源同步 locale 文件时使用此命令。composer run style—— 执行vendor/bin/pint --parallel应用 pint.json 中定义的 PHP 代码风格规则。post-update-cmd—— 在依赖更新后自动运行 codestyler 任务与composer normalize一般无需直接调用。Pint 规则pint.jsonPint 配置 采用laravel预设并叠加若干项目专属规则要点包括declare_strict_typesPHP 文件顶部应包含declare(strict_types1);fully_qualified_strict_types统一导入并使用完全限定类名FQCNphp_unit_method_casing camel_case测试方法必须使用 camelCase 命名binary_operator_spaces默认align_single_space_minimal对齐最小化引入多套 PHP 迁移规则集PHP7x1Migration、PHP7x3Migration、PHP7x4Migration、PHP8x0Migration、PHP8x1Migration、PHP8x2Migration面向可读性的 phpdoc 与空行规则blank_line_before_statement针对declare/phpdoc/continue/return类布局与类型排序偏好class_attributes_separation、class_definition、ordered_types等exclude排除了tests/Fixtures该目录不做风格检查。Biome 配置biome.jsonBiome 配置 用于vendor/、node_modules/之外的 JSON/JS 格式化与 lintVCS 集成被禁用vcs.enabled false、useIgnoreFile false因此默认不会遵循.gitignorefiles.includes显式排除了node_modules、vendor以及若干根目录文件如composer.json、composer.lock、package.json、package-lock.json等格式化采用 4 空格缩进JS 使用双引号quoteStyle: doubleJSON 格式化开启bracketSpacing与expand: always。格式化命令示例npx biomejs/biome format .测试配置、运行与编写PHPUnit 配置phpunit.xml 位于仓库根目录Bootstrapvendor/autoload.php环境变量APP_KEY已在 phpunit.xml 中预设值为AckfSECXIvnK5r28GVIWUAxmbBSjTsmF测试时通常无需自行导出环境变量测试套件目录./tests覆盖率/解析来源包含./src。运行测试运行完整测试套件带测试名输出# *nix vendor/bin/phpunit -c phpunit.xml --testdox # Windows PowerShell注意反斜杠路径 vendor\bin\phpunit -c phpunit.xml --testdox按类名或测试名过滤适合快速反馈vendor/bin/phpunit -c phpunit.xml --filter PluginTest --testdox说明Windows PowerShell 下路径使用反斜杠*nix 下使用正斜杠。该指南验证记录显示全套测试在 PHP 8.4 与 PHPUnit 12 环境下Windows执行成功。添加测试测试文件置于tests/下命名空间为Tests由 composer.json 的autoload-dev自动加载。基础测试类有两种选择仓库内部、与框架无关的检查直接继承PHPUnit\Framework\TestCase与 locale/status 基础设施集成的测试继承LaravelLang\StatusGeneratorTests\TestCase参见 tests/PluginTest.php其通过protected string $base_path __DIR__ . /../指向仓库根以复用 status-generator 包提供的助手与 fixtures。命名与风格约定测试方法使用 camelCase由 Pint 规则php_unit_method_casingcamel_case强制测试文件顶部声明严格类型declare(strict_types1);。最小示例仅依赖 PHPUnit?php declare(strict_types1); namespace Tests; use PHPUnit\Framework\TestCase; final class DemoExampleTest extends TestCase { public function test_it_runs_a_trivial_assertion(): void { $this-assertSame(2, 1 1); } }仅运行该测试vendor/bin/phpunit -c phpunit.xml --filter DemoExampleTest --testdox该示例在编写本指南时被创建并执行验证随后已删除以保持仓库整洁。本地化文件同步与格式化locales/下的翻译产物属于生成/维护型文件不应脱离生成管线手工编辑。更新翻译数据的推荐流程是composer run format该命令会先执行vendor/bin/lang sync从source/同步 locale 文件再经由style脚本应用 Pint 保持代码风格一致。对翻译数据做出改动后始终运行composer run style以确保风格统一。若修改了 JSON/JS 配置或 locale JSON还需运行 Biome 规范化格式。本地化翻译规则本仓库的翻译工作遵循一套严格的规则见指南 Localization translation rules 一节核心原则如下按 ISO-639-1 语言代码翻译目标语言由locales/下的文件夹名决定翻译成与该 locale 代码对应的语言不翻译以_开头的文件如_excludes.json、_not_translatable.jsonkey 本身保持不译即使 key 看起来像句子若译文与英文原值完全相同将该值加入_excludes.json以:占位符开头的句子译文以大写字母开头例如:Attribute est déjà attaché(e).考虑使用上下文这些值会展示在网站页面的选择字段、信息通知、UI 元素等处翻译完成后将修改过的 JSON 文件内容按字母序排序翻译后不运行单元测试和/或代码风格检查严格遵循当前英文措辞保留占位符如:attribute、:value等。inline 与普通文件之别*-inline.json与其他文件的区别在于它们提供的译文不提及属性或字段名。例如*.jsonThe :attribute field must only contain letters.The :attribute field must have :value items or more.*-inline.jsonThe value must only contain letters.This field must contain :value items or more.参考原文与状态文件翻译时以locales/en/下的英文文件为原文参照见 locales/en按文件类型一一对应locales/*/json.json↔locales/en/json.jsonlocales/*/json-inline.json↔locales/en/json-inline.jsonlocales/*/php.json↔locales/en/php.jsonlocales/*/php-inline.json↔locales/en/php-inline.json只翻译以英文书写的短语此前已翻译的短语无需重述除非另有说明。所有指定文件应在同一个提交中完成翻译。各语言尚未翻译的单词与短语清单位于docs/statuses/文件夹文件名与locales/中的语言代码一一对应如 docs/statuses/zh_CN.md。每个文件内部是一个 HTML 表格第一列为 JSON 文件中的 key 名第二列为待翻译的值。如何翻译词汇和短语注意最重要的一条规则是——不要删除文件中的 key。完整的翻译操作流程如下打开docs/statuses中对应语言代码的文件仔细研读在待翻译的本地化 JSON 文件中定位这些短语翻译单词与短语写回它们原先所在的 JSON 文件位置运行控制台命令更新翻译状态必须执行vendor/bin/lang sync vendor/bin/lang status根据命令输出检查docs/statuses下该语言 Markdown 文件的内容若 Markdown 文件包含All missed: 0则翻译工作完成否则继续翻译文件中列出的短语并从第 2 步起重复。例如 docs/statuses/zh_CN.md 当前显示All missed: 7其中json部分缺失 3 条如The existing encrypted environment file is not in readable format. Use --force to overwrite it.等这些条目正是下一步需要补齐翻译的目标。常见陷阱与提交卫生确保 PHP 8.2旧版本 PHP 不受支持见 composer.jsonrequire段本地运行测试前必须安装 dev 依赖composer install不加--no-dev否则laravel-lang/status-generator的基础测试类不可用部分目录/文件是生成的除非清楚生成流程否则避免手工编辑 locale 生成文件优先更新source/数据并运行composer run format提交前保持 diff 最小运行composer run style以满足 Pint 规则若修改 JSON/JS 配置或 locale JSON运行 Biome 规范化格式若向 upstream 贡献遵循 conventional commit 约定。通过遵循上述环境搭建、测试、同步与翻译规则贡献者可以高效地为 128 种语言的 Laravel 生态翻译资源库提交高质量改动并确保每次翻译都通过lang status的完整性校验。赞分享后端【免费下载链接】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 Lang开发环境搭建贡献代码的本地配置Laravel Lang开发环境搭建贡献代码的本地配置 你还在为贡献Laravel国际化语言包而烦恼环境配置本文将带你3步完成本地开发环境搭建5分钟上手代后端React Native Navigation 贡献指南本地开发环境搭建、测试驱动工作流与仓库结构全解React Native Navigation 贡献指南本地开发环境搭建、测试驱动工作流与仓库结构全解 本文基于仓库根目录 CONTRIBUTING.md h移动开发Zod 仓库贡献开发指南从本地环境搭建、测试到文档构建的完整工作流Zod 仓库贡献开发指南从本地环境搭建、测试到文档构建的完整工作流 本篇技术指南以 zod 开源仓库的贡献与开发流程为线索完整梳理从「提出 Issue」到「后端前端上一篇Node.js 苹果推送通知终极指南如何在 Node.js 中实现 iOS 推送功能下一篇CANN/PyPTO样例运行指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
