CakePHP 3新手求助：如何将CMS页面URL改写为SEO友好格式？

嘿，作为玩了好几年CakePHP的老鸟，我来帮你搞定这个URL重写的需求！你要把https://example.com/pages/view/8改成https://example.com/about-us，其实分几步就能轻松实现，我给你一步步拆解：

第一步：配置自定义路由 #

首先得在config/routes.php里加一条自定义路由，让系统能识别像about-us这样的URL，并映射到对应的控制器动作。记得把这条路由放在默认路由（$routes->fallbacks()）之前，不然会被默认路由抢先匹配哦！

// 在routes.php文件中，插入到$routes->fallbacks()之前
$routes->connect(
    '/:url',
    ['controller' => 'Pages', 'action' => 'viewByUrl'],
    [
        'pass' => ['url'], // 把url参数传递给控制器动作
        'url' => '[a-z0-9-]+' // 限制url只能是小写字母、数字和横杠，符合SEO规范
    ]
);

第二步：在PagesController中添加新动作 #

接下来要在src/Controller/PagesController.php里新增一个viewByUrl动作，用来根据页面的url字段值查找对应的页面数据：

public function viewByUrl($url)
{
    // 根据url字段查找页面
    $page = $this->Pages->findByUrl($url)->first();
    
    // 如果找不到页面，抛出404错误
    if (!$page) {
        throw new NotFoundException(__('抱歉，找不到你要访问的页面'));
    }
    
    // 把页面数据传给视图
    $this->set(compact('page'));
    // 复用原来的view视图文件，不用新建视图
    $this->render('view');
}

这样一来，当用户访问https://example.com/about-us时，系统会调用这个动作，通过about-us这个值找到对应的页面，然后用原来的view.ctp视图渲染内容，完美复用现有代码！

第三步：确保URL字段的唯一性（重要！） #

为了避免多个页面使用相同的url值导致冲突，最好给数据库的url字段加个唯一索引。执行下面的SQL语句就行：

ALTER TABLE `pages` ADD UNIQUE INDEX `url_unique` (`url`);

另外，在保存页面的时候，最好做个验证，强制url字段只能是小写字母、数字和横杠，比如在PagesTable.php的validationDefault方法里加规则：

$validator
    ->add('url', 'validFormat', [
        'rule' => ['custom', '/^[a-z0-9-]+$/'],
        'message' => 'URL只能包含小写字母、数字和横杠'
    ])
    ->requirePresence('url', 'create')
    ->notEmptyString('url')
    ->add('url', 'unique', ['rule' => 'validateUnique', 'provider' => 'table']);

第四步：测试验证 #

现在你可以访问https://example.com/about-us试试啦，应该能正常显示对应的页面内容。原来的https://example.com/pages/view/8也依然可以访问（如果你不需要保留的话，也可以修改或删除原来的路由）。

额外注意点 #

• 路由顺序真的很重要！自定义路由一定要放在$routes->fallbacks()之前，不然默认路由会先匹配，导致你的自定义URL不生效。
• 如果还有其他类似的自定义路由，记得把更具体的路由放在前面，避免冲突。

内容的提问来源于stack exchange，提问作者Yogendra - eCommerce Developer