Laravel 多语言翻译缓存可通过内置命令或自定义命令实现:一、运行 php artisan lang:cache 将语言文件编译为 bootstrap/cache/lang.php;二、手动创建 CacheTranslations 命令,遍历 lang/{locale} 目录,合并 PHP 翻译数组并写入 bootstrap/cache/compiled-lang.php。

如果您在 Laravel 应用中频繁加载语言文件,但每次请求都重新解析 JSON 或 PHP 数组格式的翻译内容,则可能导致 I/O 开销增加和响应延迟。以下是为多语言翻译内容启用缓存的多种方法:
一、启用内置的翻译缓存命令
Laravel 提供了 Artisan 命令用于将所有语言文件编译为优化后的缓存结构,该缓存以 PHP 数组形式存储,避免重复文件读取与解析。
1、打开终端并进入 Laravel 项目根目录。
2、执行 php artisan lang:publish(如使用 Laravel 11+ 的新语言系统)或确保语言文件位于 lang/ 目录下。
3、运行 php artisan lang:cache 命令生成缓存文件。
4、确认缓存文件已写入 bootstrap/cache/lang.php 路径。
二、手动预编译语言文件为 PHP 缓存数组
当需要更精细控制缓存生成逻辑(例如仅缓存特定语言或排除某些键),可编写自定义 Artisan 命令,遍历 lang/{locale} 下的所有 PHP 文件,合并并序列化为单个可直接 require 的数组文件。
1、创建命令:运行 php artisan make:command CacheTranslations。
2、在 app/Console/Commands/CacheTranslations.php 的 handle() 方法中,使用 File::files(lang_path()) 获取全部语言子目录。
3、对每个 locale 子目录,递归读取所有 .php 文件,调用 require 获取翻译数组,并按 locale 键组织嵌套结构。
4、将最终数组写入 bootstrap/cache/compiled-lang.php,内容以 格式开头。
三、使用 APCu 或 Redis 作为翻译键值缓存后端
适用于动态翻译内容(如数据库驱动的多语言字段),通过扩展 Illuminate\Translation\Translator 类,将翻译键映射关系存储在高速内存缓存中,绕过文件系统访问。
1、在 config/app.php 的 providers 数组中,注释默认 Illuminate\Translation\TranslationServiceProvider::class。
2、创建自定义服务提供者 App\Providers\CachedTranslationServiceProvider,在 register() 中绑定继承自 Translator 的新类。
3、重写 getFromJson() 和 getLine() 方法,在返回前尝试从 Cache::store('apcu') 或 Cache::store('redis') 获取键值对。
4、在翻译更新时,调用 Cache::store('apcu')->forget("lang.{$locale}.{$key}") 清除对应缓存项。
四、配置环境变量禁用开发模式下的翻译缓存刷新
在本地开发过程中,频繁修改语言文件需即时生效;而生产环境应始终使用缓存。通过 APP_DEBUG 和 CACHE_LANG 配合控制行为,避免手动清理缓存的操作干扰部署流程。
1、在 config/app.php 中添加 'cache_lang' => env('CACHE_LANG', true) 配置项。
2、修改 vendor/laravel/framework/src/Illuminate/Translation/TranslationServiceProvider.php 的 registerLoader() 方法(或通过事件监听器覆盖),在实例化 FileLoader 前检查 config('app.cache_lang') 值。
3、若为 false,则跳过 loadCachedPaths() 调用,强制每次从磁盘读取原始语言文件。
4、在 .env 中设置 CACHE_LANG=false(开发)或 CACHE_LANG=true(生产)。


















