You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何在CakePHP中禁用自动路由功能?

在CakePHP中禁用自动路由,仅允许自定义路由

要实现只允许访问已定义路由、禁用默认的controller/action自动路由,只需修改路由配置文件并移除自动路由规则即可,不同CakePHP版本的操作略有区别:

CakePHP 3.x/4.x 配置步骤

  1. 打开config/routes.php文件
  2. 找到Router::scope()代码块,移除或注释掉以下两行关键代码:
    • 移除默认的控制器/动作路由规则:$routes->connect('/:controller/:action/*');
    • 移除启用自动路由的fallbacks方法:$routes->fallbacks(DashedRoute::class);
  3. 添加你的自定义路由,比如将/login指向UsersController的login动作:
    $routes->connect('/login', ['controller' => 'Users', 'action' => 'login']);
    

完整示例配置:

use Cake\Routing\Route\DashedRoute;
use Cake\Routing\Router;

Router::defaultRouteClass(DashedRoute::class);

Router::scope('/', function ($routes) {
    // 注释/移除自动路由相关规则
    // $routes->connect('/:controller/:action/*');
    // $routes->fallbacks(DashedRoute::class);

    // 自定义路由
    $routes->connect('/login', ['controller' => 'Users', 'action' => 'login']);
    // 可添加更多自定义路由...
});

CakePHP 5.x 配置步骤

  1. 打开config/routes.php文件
  2. 在Router::scope()代码块中,移除默认的$builder->fallbacks()调用(该方法包含自动路由逻辑)
  3. 添加自定义路由:
    $builder->connect('/login', ['controller' => 'Users', 'action' => 'login']);
    

完整示例配置:

use Cake\Routing\RouteBuilder;
use Cake\Routing\Router;

Router::scope('/', function (RouteBuilder $builder) {
    // 移除自动路由的fallbacks方法
    // $builder->fallbacks();

    // 自定义路由
    $builder->connect('/login', ['controller' => 'Users', 'action' => 'login']);
    // 可添加更多自定义路由...
});

验证效果

配置完成后,访问hostname/user/login会返回404错误,而hostname/login可以正常访问到UsersController的login动作。如果是生产环境,记得清除路由缓存确保配置生效。

内容的提问来源于stack exchange,提问作者Mukesh Patel

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.06.24 06:44:54