Laravel 翻译检查器:轻松管理多语言项目
在开发多语言支持的 Laravel 项目时,你是否曾为遗漏的翻译而感到困扰?是否因为用户反馈界面显示了奇怪的字符串而头疼?现在,有了 Laravel 翻译检查器,这些问题将迎刃而解!
项目介绍
Laravel 翻译检查器 是一个专为 Laravel 框架设计的开源工具,旨在帮助开发者快速检测项目中缺失的翻译。通过简单的命令行操作,你可以轻松找出哪些语言文件中缺少了哪些翻译项,从而确保你的多语言项目始终保持一致性和完整性。
项目技术分析
技术栈
- Laravel: 基于 Laravel 框架开发,充分利用了 Laravel 的命令行工具和配置系统。
- Composer: 通过 Composer 进行包管理,方便开发者快速集成到现有项目中。
- PHP: 使用 PHP 编写,支持 PHP 8.0 及以上版本。
核心功能
- 自动检测翻译缺失: 通过简单的命令行操作,自动扫描项目中的翻译文件,找出缺失的翻译项。
- 支持多种文件格式: 支持
.php
和.json
格式的翻译文件。 - 灵活的配置选项: 允许开发者自定义扫描目录、排除特定目录或文件类型,以及排除特定语言。
- GitHub Actions 集成: 支持在 GitHub Actions 中运行,实现持续集成和持续部署。
项目及技术应用场景
应用场景
- 多语言网站开发: 在开发多语言支持的网站时,确保所有语言文件中的翻译项完整无缺。
- 国际化项目: 在国际化项目中,及时发现并修复翻译缺失问题,提升用户体验。
- 持续集成与部署: 通过 GitHub Actions 集成,实现自动化翻译检查,确保每次代码提交都符合翻译规范。
技术应用
- 命令行工具: 通过
php artisan translations:check
命令,快速启动翻译检查。 - 配置文件: 通过配置文件自定义检查规则,如排除特定目录或文件类型。
- GitHub Actions: 在 CI/CD 流程中集成翻译检查,确保代码质量。
项目特点
1. 简单易用
只需一行命令,即可启动翻译检查,无需复杂的配置和操作。
php artisan translations:check
2. 高度可定制
支持自定义扫描目录、排除特定目录或文件类型,以及排除特定语言,满足不同项目的需求。
php artisan translations:check --directory=resources/lang --excludedDirectories=lang/vendor
3. 支持多种文件格式
无论是 .php
还是 .json
格式的翻译文件,都能轻松处理。
4. 持续集成支持
通过 GitHub Actions 集成,实现自动化翻译检查,确保每次代码提交都符合翻译规范。
translations:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v2
- name: Setup PHP
uses: shivammathur/setup-php@v2
with:
php-version: '8.0'
extensions: mbstring, intl
ini-values: post_max_size=256M, max_execution_time=180
coverage: xdebug
tools: php-cs-fixer, phpunit
- name: Install Dependencies
run: composer install -q --no-interaction --no-scripts
- name: Run translations check
run: php artisan translations:check --excludedDirectories=vendor
5. 详细的输出报告
检查完成后,会生成详细的输出报告,列出所有缺失的翻译项,方便开发者快速定位和修复问题。
The language nl (resources/lang/nl) is missing the file ( passwords.php )
Missing the translation with key: nl.passwords.reset
Missing the translation with key: nl.passwords.sent
Missing the translation with key: nl.passwords.throttled
Missing the translation with key: nl.passwords.token
Missing the translation with key: nl.passwords.user
结语
Laravel 翻译检查器 是一个强大且易用的工具,能够帮助你在多语言项目中轻松管理翻译文件,确保项目的国际化和本地化工作顺利进行。无论你是个人开发者还是团队成员,这个工具都能为你节省大量时间和精力,提升开发效率。赶快尝试一下吧!
composer require larswiegers/laravel-translations-checker
更多信息,请访问 GitHub 项目页面。