Laravel本地化文件写入异常：仅描述写入，标题被忽略求助

核心问题 #

你的代码中两次独立调用updateLocaleFiles分别处理标题和描述，每次操作都会完整读取并覆盖目标locale文件。如果第一次写入标题后，文件读取环节出现异常（比如OPcache缓存未更新、文件语法错误），第二次写入描述时就会基于空数组添加键值对，最终导致标题被覆盖丢失。

修复步骤 #

1. 批量处理键值对，减少文件读写次数 #

将标题和描述的键值对一次性传入处理，避免多次读写文件带来的风险：

修改save方法中的调用逻辑：

// 替换原有的两次独立调用
$this->updateLocaleFiles([
    $uniqueTitleKey => $this->name,
    $uniqueDescKey => $this->description,
]);

同步修改updateLocaleFiles方法，支持批量处理：

private function updateLocaleFiles(array $keyValuePairs)
{
    $currentLocale = app()->getLocale();
    $targetLocales = ['pt', 'es', 'fr', 'it', 'nl', 'en'];

    // 移除当前使用的语言，避免重复处理
    $index = array_search($currentLocale, $targetLocales);
    if ($index !== false) {
        unset($targetLocales[$index]);
    }

    // 先处理当前语言
    $this->updateLocaleFile($keyValuePairs, $currentLocale);

    // 批量翻译并处理其他目标语言
    foreach ($targetLocales as $locale) {
        try {
            $translatedPairs = [];
            foreach ($keyValuePairs as $key => $value) {
                $translatedPairs[$key] = $this->translate($value, $currentLocale, $locale);
            }
            $this->updateLocaleFile($translatedPairs, $locale);
        } catch (\Exception $e) {
            Log::error("翻译语言 '{$locale}' 失败: " . $e->getMessage());
        }
    }
}

2. 修复文件读取的错误处理逻辑 #

确保读取locale文件时能捕获语法错误，避免因文件格式问题导致数组为空：

private function updateLocaleFile(array $keyValuePairs, $locale)
{
    try {
        $localePath = base_path("lang/{$locale}");

        if (!is_dir($localePath)) {
            mkdir($localePath, 0755, true);
        }

        $localeFile = "{$localePath}/services.php";
        $localeArray = [];

        if (file_exists($localeFile)) {
            // 捕获include时的语法错误，避免直接返回空数组
            $includeResult = @include($localeFile);
            if ($includeResult !== false) {
                $localeArray = $includeResult;
            } else {
                Log::error("读取locale文件失败，文件语法错误: {$localeFile}");
            }
        }

        // 合并新键值对到现有数组
        $localeArray = array_merge($localeArray, $keyValuePairs);

        // 添加文件锁，防止并发写入冲突
        $phpCode = "<?php\n\nreturn " . var_export($localeArray, true) . ";\n";
        file_put_contents($localeFile, $phpCode, LOCK_EX);

        Log::info("Locale文件 '{$locale}' 更新成功");
    } catch (\Exception $e) {
        Log::error("更新Locale文件失败 '{$locale}': " . $e->getMessage());
    }
}

3. 解决OPcache缓存干扰（开发环境） #

如果开发环境开启了OPcache，会导致include读取缓存的旧文件内容，可在写入后强制清除缓存：

// 在file_put_contents之后添加以下代码
if (function_exists('opcache_invalidate')) {
    opcache_invalidate($localeFile, true);
}

4. 可选：使用Laravel内置本地化方法替代自定义逻辑 #

Laravel自带Lang::addLines方法可更安全地添加本地化内容，避免手动处理文件的风险：

use Illuminate\Support\Facades\Lang;

private function updateLocaleFile(array $keyValuePairs, $locale)
{
    Lang::addLines($keyValuePairs, $locale, 'services');
    
    // 如需持久化到文件，可参考Laravel官方本地化文件写入逻辑实现
}

验证方式 #

1. 创建新服务并同时填写标题和描述
2. 查看lang/[locale]/services.php文件，确认标题和描述的键值对均存在
3. 检查日志文件，确认无读取或写入错误

内容的提问来源于stack exchange，提问作者José Pedro