CakePHP 4 locales切换失效求助：语言切换功能无法正常工作

你的代码逻辑能走对分支，但语言切换后不生效，核心有两个问题：

1. 语言设置未持久化 #

I18n::setLocale()仅在当前请求中生效，跳转后的新请求会重新初始化，语言设置被重置为默认值。必须把用户选择的语言持久化到Session或Cookie中，确保每次请求都能读取并应用该设置。

修复方法： #

修改changeLang方法，将语言设置存入Session：

public function changeLang():void
{
    $newLocale = I18n::getLocale() !== 'en_US' ? 'en_US' : 'es_ES';
    I18n::setLocale($newLocale);
    // 将语言设置存入Session
    $this->request->getSession()->write('Config.locale', $newLocale);
    $this->redirect($this->referer());
}

然后在AppController的initialize方法中，每次请求时读取Session的语言设置并应用：

public function initialize(): void
{
    parent::initialize();
    
    $session = $this->request->getSession();
    // 优先使用Session中保存的语言，无则用默认配置
    if ($session->check('Config.locale')) {
        I18n::setLocale($session->read('Config.locale'));
    } else {
        I18n::setLocale(Configure::read('App.defaultLocale'));
    }
}

2. PO文件的翻译方向搞反了 #

CakePHP的翻译逻辑是：msgid是原始语言（默认语言）的字符串，msgstr是目标语言的翻译。你当前的locales/es/default.po中，msgid是西班牙语，msgstr是英文，这和实际需求完全相反——当切换到es_ES时，系统会寻找原始字符串（比如英文"Registered user."）对应的西班牙语翻译，但你的PO文件里msgid是西语，根本无法匹配。

修复方法： #

调整PO文件的msgid和msgstr：

#: ./src/Controller/AddressController.php:72
#: ./src/Controller/UserController.php:81
msgid "Registered user."
msgstr "Usuario registrado."

这样当语言切换为es_ES时，系统会把原始的英文"Registered user."正确翻译成西班牙语"Usuario registrado."。

内容的提问来源于stack exchange，提问作者Iria