用途:在 Laravel 项目中实现国际化与本地化,包括翻译调用、语言文件组织、复数处理、区域检测与日期/数字/货币格式化。
主要能力:区分 PHP 语言文件(支持嵌套、短键,适合结构化翻译)与 JSON 文件(扁平、全文键,适合大型应用);提供决策指引,如基础字符串用 __('key')、带变量用 __('key', ['name' => $value])、复数用 trans_choice('key', $count)、Blade 中用 @lang('key') 或 {{ __('key') }}、区域检测用中间件、格式化用 LocalizationService、包字符串用 trans('package::key')。
使用方式:资料规定强制智能体工作流——实现前并行启动三个 Agent:explore-codebase 检查现有翻译模式、research-expert 通过 Context7 核实最佳实践、mcp__context7__query-docs 查阅 Laravel 本地化文档;实现后运行 fuse-ai-pilot:sniper 校验。参考文档覆盖 setup、复数、Blade、中间件、格式化、包翻译与最佳实践;模板含 SetLocaleMiddleware、lang 文件、LocaleServiceProvider、LocaleRoutes。
关键规则:禁止拼接字符串,改用 :placeholder;复数必须处理零值;按键按功能分组(如 auth.login.title);尽早抽取字符串,视图不硬编码;用枚举或白名单校验区域。
Laravel 13 说明:本地化 API 未变;Context::add('locale', $locale) 可将区域传入队列任务;cache.serializable_classes 默认 false,缓存 Locale 对象需列出;SetLocale 中间件兼容新的 PreventRequestForgery 中间件。
限制:资料未提供安装命令、收费、价格或平台信息。