OpenCart 4移除URL中?language=参数后路由报错求助

问题分析 #

你当前的代码虽然能移除language参数，但存在三个核心问题：

• 硬编码了common/home路由和具体语言，无法适配其他页面或新增语言
• 直接覆盖$url值破坏了原有SEO URL的构建逻辑，导致路由解析时无法匹配正确的控制器
• 只处理了首页场景，其他页面的language参数仍会存在且路由会出错

解决方案 #

需要同时处理**URL生成（移除language参数）和URL解析（通过前缀识别语言）**两部分逻辑，并且配合后台语言设置完成配置：

1. 后台配置语言SEO关键词 #

进入OpenCart后台完成基础配置：

• 依次打开系统 → 本地化 → 语言
• 编辑English (GB)，设置SEO关键词为en
• 编辑French语言，设置SEO关键词为fr
• 保存设置

2. 修改SEO URL控制器代码 #

替换你当前添加的代码，在catalog/controller/startup/seo_url.php的index方法中做两处修改：

第一处：处理URL生成（移除language参数）

找到构建URL参数的循环部分，添加跳过language参数的逻辑：

// 在处理URL参数的循环中（代码中间位置）
foreach ($data as $key => $value) {
    // 跳过language参数，依赖URL前缀识别语言
    if ($key === 'language') {
        continue;
    }
    
    // 保留原有参数处理逻辑
    if (isset($part[1])) {
        $url .= '/' . $this->utf8->urlencode($value);
    } else {
        $query[$key] = $value;
    }
}

第二处：处理URL解析（通过前缀识别语言）

在index方法最开头添加前缀解析逻辑：

// 在index方法起始位置添加
$url = $this->request->get['_route_'] ?? '';
$language_code = '';

// 匹配URL中的语言前缀（如/en、/fr）
if (preg_match('/^\/?(en|fr)/', $url, $matches)) {
    $language_code = $matches[1];
    // 移除前缀，保证后续路由能正常解析
    $this->request->get['_route_'] = preg_replace('/^\/?'.$language_code.'/', '', $url);
    
    // 映射SEO关键词到系统语言代码
    $language_map = [
        'en' => 'en-gb',
        'fr' => 'fr'
    ];
    
    if (isset($language_map[$language_code])) {
        $this->config->set('config_language', $language_map[$language_code]);
        $this->session->data['language'] = $language_map[$language_code];
    }
}

3. 验证与缓存清理 #

• 清理OpenCart缓存：后台→系统→设置→编辑商店→服务器→清理缓存
• 测试访问：example.com/en应加载英文首页，example.com/fr加载法文首页，URL不再带有?language=参数
• 测试其他页面：如example.com/en/product/category也不应出现language参数

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