CakePHP 3.x批量配置旧URL到带语言前缀新URL的301重定向

我完全理解你要处理数百个页面的旧URL重定向，不想逐个写规则的痛点。咱们可以利用CakePHP的动态路由能力，写一个通用的重定向规则，一次性搞定所有旧URL的跳转需求。

核心思路 #

通过定义一个匹配所有/controller/action结构的路由，结合回调函数动态处理语言参数转换、URL拼接，同时保留其他查询参数，实现自动跳转。

具体实现步骤 #

首先打开你的config/routes.php文件，按以下步骤添加代码：

1. 先定义语言代码映射表

旧的查询参数用的是eng这类标识，新URL用en前缀，先把对应关系整理成映射表，方便后续维护：

// 旧语言代码 => 新语言前缀的映射
$languageMap = [
    'eng' => 'en',
    'fra' => 'fr',
    'deu' => 'de',
    // 这里按需添加其他语言的映射关系
];

2. 添加通用重定向路由

把这个路由放在所有其他路由的最前面，确保它优先匹配旧URL：

$routes->redirect(
    '/:controller/:action',
    function ($params, $request) use ($languageMap) {
        // 没有language查询参数的话，直接返回原路径（也可以改成跳转到默认语言）
        if (!isset($request->getQuery('language'))) {
            return '/' . $params['controller'] . '/' . $params['action'];
        }

        $oldLangCode = $request->getQuery('language');
        // 匹配新语言前缀，没有匹配到就用默认的'en'
        $newLangPrefix = isset($languageMap[$oldLangCode]) ? $languageMap[$oldLangCode] : 'en';

        // 构建基础的新URL路径
        $newUrl = '/' . $newLangPrefix . '/' . $params['controller'] . '/' . $params['action'];

        // 保留除language外的其他查询参数
        $queryParams = $request->getQueryParams();
        unset($queryParams['language']);
        if (!empty($queryParams)) {
            $newUrl .= '?' . http_build_query($queryParams);
        }

        return $newUrl;
    },
    [
        'pass' => ['controller', 'action'],
        'status' => 301, // 永久重定向，对SEO友好
        'persist' => false, // 禁止自动保留原查询参数，我们手动处理
    ]
);

3. 处理根路径的特殊情况（可选）

如果你的旧URL存在/?language=eng这类根路径带语言参数的情况，可以再加一个路由：

$routes->redirect(
    '/',
    function ($params, $request) use ($languageMap) {
        if (!isset($request->getQuery('language'))) {
            return '/';
        }

        $oldLangCode = $request->getQuery('language');
        $newLangPrefix = isset($languageMap[$oldLangCode]) ? $languageMap[$oldLangCode] : 'en';
        
        $queryParams = $request->getQueryParams();
        unset($queryParams['language']);
        $newUrl = '/' . $newLangPrefix;
        
        if (!empty($queryParams)) {
            $newUrl .= '?' . http_build_query($queryParams);
        }

        return $newUrl;
    },
    [
        'status' => 301,
        'persist' => false,
    ]
);

关键细节说明 #

• 路由优先级：一定要把重定向路由放在最前面，CakePHP是按路由定义顺序匹配的，先匹配到的规则会先执行。
• 301重定向：用永久重定向状态码，告诉搜索引擎该URL已永久迁移，有助于SEO权重的传递。
• 查询参数保留：代码中会自动去掉language参数，但保留其他所有查询参数，比如旧URL/posts/view?id=5&language=eng会被转成/en/posts/view?id=5。
• 异常处理：如果遇到未在映射表中的语言代码，会默认跳转到en前缀的页面，你可以根据需求修改默认值。

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