Symfony 4 实现本地化多语言 URL 的核心是将 _locale 深度融入路由生命周期：路由路径必须显式包含 /{_locale} 占位符并配置 requirements 与 defaults，URL 生成时需显式传参或确保 RequestContext 正确推导，同时启用 LocaleAwareListener、translator 和 session 以支持自动解析、切换与持久化。
Symfony 4 中实现本地化多语言 URL，核心是让路由同时承载语言标识（如 /en/blog、/zh/blog）并支持自动切换和正确生成，而不是靠手动拼接或硬编码。关键不在于“加个参数”，而在于把 _locale 真正融入路由生命周期：匹配时识别、生成时补全、跳转时保持。
路由定义必须显式声明 _locale 占位符
不能只在控制器里读取 locale，URL 生成器需要明确知道该参数是路径的一部分。所有需多语言支持的路由，路径中要包含 {_locale}，且设为必需或可选但有默认值：
- 推荐写法（必需 locale，强制语言前缀）：
#[Route('/{_locale}/blog/{slug}', name: 'blog_show', requirements: ['_locale' => '[a-z]{2}'])] - 若允许无前缀访问（如默认语言），可用可选参数 + defaults：
#[Route('/{_locale}/blog/{slug}', name: 'blog_show', defaults: ['_locale' => 'en'], requirements: ['_locale' => '[a-z]{2}'])] - YAML 配置同理：
blog_show:<br> path: /{_locale}/blog/{slug}<br> defaults: { _controller: 'App\Controller\BlogController::show', _locale: 'en' }<br> requirements: { _locale: '[a-z]{2}' }
生成 URL 时必须传入 _locale，或确保上下文已设置
Twig 或控制器中调用 path() / generate() 时，_locale 是 mandatory 参数（除非你设了默认值且未覆盖）。漏传会导致“Some mandatory parameters are missing”错误：
- Twig 中：
{{ path('blog_show', { _locale: 'zh', slug: 'symfony-url' }) }}→/zh/blog/symfony-url - 控制器中：
$url = $this->generateUrl('blog_show', ['_locale' => 'ja', 'slug' => 'symfony-url']); - 如果当前请求已有合法
_locale（比如通过 LocaleListener 解析自 URL 或 cookie），且路由定义含默认值，生成器可自动复用，但不建议依赖此行为——显式传参更清晰、更可控。
自动解析与切换 locale 的基础设施要配齐
仅定义路由不够，还需让 Symfony 知道每次请求的 _locale 从哪来、怎么存、怎么切：
- 启用
framework.translator和framework.default_locale（如en） - 配置
framework.locale为%kernel.default_locale%，并确保request_listener已启用（Symfony 4 默认开启） - 确保
LocaleAwareListener在事件链中生效——它会从 URL 路径、cookie、accept-language 头按优先级提取_locale并设入 Request - 若需语言切换链接（如页脚语言选择器），用
path()重用当前路由名，只替换_locale：{{ path(app.request.attributes.get('_route'), app.request.attributes.get('_route_params')|merge({'_locale': 'fr'})) }}
避免常见陷阱：requirements、缓存与子请求
多语言 URL 容易因细节疏忽失效：
-
requirements正则必须匹配实际传入值，例如[a-z]{2}不匹配pt_BR；如需地区码，改用[a-z]{2}(_[A-Z]{2})? - 使用
path()生成相对 URL，url()生成绝对 URL；邮件或 API 中务必用url()，否则链接缺失域名 - 路由缓存（
cache:clear）后修改了路由定义，必须清除路由缓存：php bin/console cache:clear --no-warmup && php bin/console cache:warmup - 子请求（如嵌入控制器）不会自动继承主请求的
_locale，需手动传递或在子请求中重新设置
