Symfony 4 中可通过 Cookie 保存用户 locale 实现自动语言切换：需配置 framework.yaml 启用 session 和 translation.yaml 启用翻译组件，并推荐创建 LocaleSwitcher 服务封装逻辑。
在 Symfony 4 中，通过 Cookie 保存用户的本地化语言（locale）是一种常见做法，目的是让用户在后续访问时自动切换到其偏好的语言，无需每次手动选择或依赖浏览器 Accept-Language。
1. 配置框架支持 locale 和 Cookie
Symfony 默认支持 locale，但需显式启用并配置 Cookie 存储机制。首先确保 config/packages/framework.yaml 中已启用 session（因为 Cookie 通常配合 session 使用，且 locale 切换逻辑常依赖 session）：
framework:
# ... 其他配置
session:
handler_id: 'session.handler.native_file'
cookie_secure: '%kernel.environment% === "prod"'
cookie_samesite: 'lax'
同时，在 config/packages/translation.yaml 中确认启用了翻译组件：
framework:
default_locale: 'en'
translator:
default_path: '%kernel.project_dir%/translations'
fallbacks:
- 'en'
2. 创建 Locale 切换器服务（推荐方式）
避免在控制器中重复写 locale 设置逻辑，建议封装为服务。创建 src/Service/LocaleSwitcher.php：
<?php
namespace App\Service;
<p>use Symfony\Component\HttpFoundation\Cookie;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\HttpKernel\Event\RequestEvent;
use Symfony\Contracts\Translation\TranslatorInterface;</p><p>class LocaleSwitcher
{
private $defaultLocale = 'en';</p><pre class='brush:php;toolbar:false;'>public function __construct(private TranslatorInterface $translator) {}
public function setLocale(Request $request, string $locale, Response $response): void
{
// 写入 Cookie（有效期 30 天）
$cookie = new Cookie('locale', $locale, time() + 30 * 86400, '/', '', false, true, false, 'Lax');
$response->headers->setCookie($cookie);
// 同步设置当前请求的 locale（影响后续翻译）
$request->setLocale($locale);
$this->translator->setLocale($locale);
}
public function getLocaleFromRequest(Request $request): string
{
$locale = $request->cookies->get('locale');
if ($locale && in_array($locale, ['en', 'fr', 'de', 'zh', 'ja'], true)) {
return $locale;
}
return $request->getPreferredLanguage(['en', 'fr', 'de', 'zh', 'ja']) ?: $this->defaultLocale;
}}
该服务提供两个核心能力：写入 locale Cookie 并同步请求 locale；从 Cookie 或 Accept-Language 安全读取 locale。
3. 在控制器中切换语言（例如 /locale/{_locale}）
定义一个简单路由用于手动切换语言：
# config/routes.yaml
app_change_locale:
path: /locale/{_locale}
controller: App\Controller\LocaleController::change
methods: [GET]
src/Controller/LocaleController.php：
<?php
namespace App\Controller;
<p>use App\Service\LocaleSwitcher;
use Symfony\Component\HttpFoundation\RedirectResponse;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;</p><p>class LocaleController
{</p><h1>[Route('/locale/{_locale}', name: 'app_change_locale')]</h1><pre class='brush:php;toolbar:false;'>public function change(string $_locale, Request $request, LocaleSwitcher $switcher): RedirectResponse
{
$response = new Response();
$switcher->setLocale($request, $_locale, $response);
// 重定向回上一页（或首页）
$referer = $request->headers->get('referer');
$url = $referer ?: '/';
return new RedirectResponse($url, 302);
}}
4. 自动应用 Cookie 中的 locale（事件监听器）
关键一步：每次请求前读取 Cookie 并设置 locale。使用 kernel.request 事件监听器：
# config/services.yaml
services:
App\EventListener\LocaleListener:
tags:
- { name: 'kernel.event_listener', event: 'kernel.request', method: 'onKernelRequest', priority: 100 }
src/EventListener/LocaleListener.php：
<?php
namespace App\EventListener;
<p>use App\Service\LocaleSwitcher;
use Symfony\Component\HttpKernel\Event\RequestEvent;</p><p>class LocaleListener
{
public function __construct(private LocaleSwitcher $switcher) {}</p><pre class='brush:php;toolbar:false;'>public function onKernelRequest(RequestEvent $event): void
{
$request = $event->getRequest();
$locale = $this->switcher->getLocaleFromRequest($request);
$request->setLocale($locale);
}}
这样，所有请求都会自动读取 Cookie 的 locale，并设置到 Request 对象中，Twig 模板、翻译函数（$translator->trans()）、表单等都能正确响应。
不复杂但容易忽略：确保你已在模板中提供语言切换链接（如 <a href="{{ path('app_change_locale', { _locale: 'zh' }) }}">中文</a>），且前端不缓存含 locale 的页面（尤其使用反向代理时注意 Vary: Accept-Language 或 Cache-Control 头）。
