Silex+Twig实现点击元素切换语言并保持URL简洁

嘿，这个需求我之前做Silex项目的时候正好处理过，给你分享几个实用的实现方案和最佳实践，应该能完美解决你的问题：

这是最直接且对SEO友好的方式，利用Silex集成的Twig路由生成功能，直接在模板里生成对应语言的页面链接。

基本用法 #

假设你的路由绑定名称是my_account，在Twig模板里可以这样写语言切换链接：

<!-- 切换到法语 -->
<a href="{{ path('my_account', {'_locale': 'fr'}) }}" class="locale-link">Français</a>
<!-- 切换到英语 -->
<a href="{{ path('my_account', {'_locale': 'en'}) }}" class="locale-link">English</a>

进阶：保留当前页面的其他URL参数 #

如果当前页面带有查询参数（比如/en/my-account?id=123），切换语言时想保留这些参数，可以用merge方法合并现有参数和新的locale：

{% set current_route = app.request.get('_route') %}
{% set current_params = app.request.query.all %}

<a href="{{ path(current_route, current_params|merge({'_locale': 'fr'})) }}">Français</a>
<a href="{{ path(current_route, current_params|merge({'_locale': 'en'})) }}">English</a>

如果想用下拉菜单这种交互方式，可以做一个隐藏的表单，选择语言后自动提交，再通过控制器处理重定向：

Twig模板代码 #

<form method="post" action="{{ path('change_locale') }}" class="locale-form">
  <select name="_locale" onchange="this.form.submit()">
    <option value="en" {{ app.request.get('_locale', app.locale) == 'en' ? 'selected' }}>English</option>
    <option value="fr" {{ app.request.get('_locale', app.locale) == 'fr' ? 'selected' }}>Français</option>
  </select>
  <!-- 隐藏提交按钮，靠下拉框的onchange触发提交 -->
  <button type="submit" style="display: none;">Change Language</button>
</form>

Silex控制器代码 #

$app->post('/change-locale', function(Request $request) use ($app) {
    // 获取选中的语言，默认用英语
    $selectedLocale = $request->request->get('_locale', 'en');
    // 可选：把用户选择的语言存在Session里，下次访问自动应用
    $app['session']->set('_locale', $selectedLocale);
    
    // 重定向回用户原来的页面，没有referer的话跳转到首页
    $refererUrl = $request->headers->get('referer', $app['url_generator']->generate('home'));
    return $app->redirect($refererUrl);
})->bind('change_locale');

1. 优先使用URL-based Locale
   你现在采用的URL带_locale的方式非常推荐，因为每个语言版本有独立URL，对搜索引擎收录友好，也符合用户的使用习惯。

2. 配置默认Locale并处理无locale的URL
   在Silex初始化时设置默认语言：

   $app['locale'] = 'en';
   

   同时给不带locale的路由做重定向，避免重复内容：

   // 带locale的主路由
   $app->get('/{_locale}/my-account', function(Request $request) use ($app) {
       return $app['twig']->render('my-account.twig');
   })->bind('my_account')->assert('_locale', 'en|fr'); // 限制locale只能是en或fr
   
   // 不带locale的路由，重定向到默认语言版本
   $app->get('/my-account', function(Request $request) use ($app) {
       return $app->redirect($app['url_generator']->generate('my_account', ['_locale' => $app['locale']]));
   });
   

3. 用Twig宏复用语言切换代码
   把语言切换的逻辑封装成Twig宏，避免在多个模板里重复写代码：

   {# 在_macros.twig里定义宏 #}
   {% macro locale_switcher(current_route, current_params) %}
       {% set current_locale = app.request.get('_locale', app.locale) %}
       <div class="locale-switcher">
           <a href="{{ path(current_route, current_params|merge({'_locale': 'en'})) }}" 
              {% if current_locale == 'en' %}class="active"{% endif %}>
               English
           </a>
           <a href="{{ path(current_route, current_params|merge({'_locale': 'fr'})) }}" 
              {% if current_locale == 'fr' %}class="active"{% endif %}>
               Français
           </a>
       </div>
   {% endmacro %}
   

   然后在需要的模板里导入使用：

   {% import '_macros.twig' as macros %}
   {{ macros.locale_switcher(app.request.get('_route'), app.request.query.all) }}
   

4. 用Session记住用户的语言偏好
   通过Silex的前置中间件，自动读取Session里的语言设置，让用户下次访问时不用再次切换：

   $app->before(function(Request $request) use ($app) {
       // 如果Session里有保存的语言，就应用它
       if ($savedLocale = $app['session']->get('_locale')) {
           $app['locale'] = $savedLocale;
       }
       // 如果URL里有locale参数，更新Session里的设置
       if ($requestLocale = $request->attributes->get('_locale')) {
           $app['session']->set('_locale', $requestLocale);
       }
   });
   

5. 给当前语言添加视觉标识
   给当前选中的语言链接/选项加上active类，用CSS区分样式，让用户清晰知道当前使用的语言。

内容的提问来源于stack exchange，提问作者Mickaël Leger