CakePHP4 CakeDC Users插件自定义登录URL或带参登录报错解决问询

优先方案：新增独立自定义登录地址 #

你遇到的报错是CakeDC Users插件默认的loginUrl校验规则限制了可识别的登录路径，按以下步骤修改即可：

• 第一步：修改路由配置，在你的项目config/routes.php里，CakeDC Users路由加载之前新增自定义登录路由，代码示例：

$routes->connect('/specialLogin', ['plugin' => 'CakeDC/Users', 'controller' => 'Users', 'action' => 'login']);
// 原有CakeDC Users路由加载代码保持不变
$routes->plugin('CakeDC/Users', ['path' => '/users'], function ($routes) {
    $routes->fallbacks('DashedRoute');
});

• 第二步：修改CakeDC Users插件配置，在config/users.php中新增允许的登录URL到白名单，同时配置自定义登录地址：

return [
    'Users' => [
        // 新增自定义登录地址到可识别登录路径列表
        'loginUrl' => [
            '/login',
            '/specialLogin',
            ['plugin' => 'CakeDC/Users', 'controller' => 'Users', 'action' => 'login'],
        ],
        // 关闭严格的登录URL校验（可选，如果你需要更灵活的路径匹配）
        'Auth' => [
            'loginAction' => '/specialLogin',
            'strictRedirect' => false,
        ]
    ]
];

• 第三步：自定义跳转逻辑，在UsersController的beforeFilter或者afterIdentify事件中添加跳转判断，你可以通过当前请求路径区分是从默认登录还是自定义登录地址进入，示例：

public function beforeFilter(EventInterface $event)
{
    parent::beforeFilter($event);
    if ($this->request->getPath() === '/specialLogin') {
        $this->Authentication->setConfig('loginRedirect', '/your-custom-redirect-path');
    }
}

备选方案：给默认登录地址增加URL参数 #

如果不需要独立登录地址，按以下配置修改即可：

• 第一步：修改路由配置支持参数传递，在routes.php中调整登录路由：

$routes->connect('/login/*', ['plugin' => 'CakeDC/Users', 'controller' => 'Users', 'action' => 'login']);

• 第二步：在config/users.php中放宽登录URL的匹配规则：

return [
    'Users' => [
        'Auth' => [
            // 允许登录URL带任意后缀参数
            'allowedLoginRedirects' => [
                '/login*',
            ],
            'strictRedirect' => false,
        ]
    ]
];

• 第三步：在登录逻辑中读取参数判断跳转路径即可，你可以通过$this->request->getParam('pass')获取自定义参数值。

报错原因说明：CakeDC Users插件内置了登录URL白名单校验，只有在loginUrl配置项中声明的路径才会被识别为合法登录入口，避免未授权的跳转风险。

内容的提问来源于stack exchange，提问作者Dennis van der Graaf