PHP Symfony多语言站点如何通过代码强制设置全局固定语言

问题原因 #

你编写的代码仅修改了当前请求实例的locale属性，执行时机晚于Symfony核心的LocaleListener，此时翻译器、模板渲染上下文已经提前加载了对应语言的资源，因此当前请求不会生效；仅存入session的_locale仅会对后续新请求生效，无法作用于当前请求。

方案1：测试场景全局固定英文（最简单） #

直接修改配置文件，完全禁用多语言切换，固定使用英文，无需额外代码：
修改config/packages/translation.yaml：

framework:
    default_locale: en
    enabled_locales: ['en']
    # 禁用从请求/用户参数读取locale
    set_locale_from_accept_language: false
    set_locale_from_request: false

修改后清除缓存执行php bin/console cache:clear即可全局生效。

方案2：运行时代码强制设置英文（无视用户选择） #

如果需要通过代码动态控制强制英文，需自定义请求事件监听器，优先级高于Symfony自带的LocaleListener（自带优先级为16，自定义设为17即可），在系统初始化locale前强制覆盖：

第一步：创建监听器文件src/EventListener/ForceEnglishLocaleListener.php #

<?php

namespace App\EventListener;

use Symfony\Component\HttpKernel\Event\RequestEvent;
use Symfony\Component\HttpKernel\KernelEvents;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

class ForceEnglishLocaleListener implements EventSubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [
            // 优先级高于核心LocaleListener，提前覆盖locale
            KernelEvents::REQUEST => [['onKernelRequest', 17]],
        ];
    }

    public function onKernelRequest(RequestEvent $event): void
    {
        if (!$event->isMainRequest()) {
            return;
        }

        $request = $event->getRequest();
        $forceLocale = 'en';
        // 强制覆盖所有来源的locale设置
        $request->setLocale($forceLocale);
        $request->attributes->set('_locale', $forceLocale);
        $request->getSession()->set('_locale', $forceLocale);
    }
}

第二步：注册监听器（如果没有开启自动装配的话） #

修改config/services.yaml：

services:
    App\EventListener\ForceEnglishLocaleListener:
        tags:
            - { name: kernel.event_subscriber }

清除缓存后即可全局生效，所有请求都会固定使用英文，无视前端用户选择的语言、请求头locale参数。

方案3：仅在指定控制器/方法临时强制英文 #

如果不需要全局生效，仅在部分逻辑中强制英文，除了修改request的locale外，需要手动同步设置翻译器的locale：

use Symfony\Contracts\Translation\TranslatorInterface;

public function test(Request $request, TranslatorInterface $translator)
{
    $locale = 'en';
    $request->setLocale($locale);
    $request->getSession()->set('_locale', $locale);
    // 手动同步翻译器的locale，让当前请求的翻译立即生效
    $translator->setLocale($locale);
    
    // 后续业务逻辑
}

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