如何在CakePHP 3中跨Action显示表单字段验证错误消息

我来帮你搞定这个验证错误消息传递的问题～

问题根源其实很明确：你现在在验证失败后用了return $this->redirect(['action' => 'login']);，重定向会触发全新的HTTP请求，原来$user实体里的验证错误信息会直接丢失，所以login页面根本拿不到这些错误内容。

下面是具体的解决步骤：

1. 修改UsersController的add动作逻辑 #

把验证失败分支的重定向改成直接渲染login视图，这样带错误的$user实体就能被传递到login页面：

public function add() {
    $user = $this->Users->newEntity();
    if ($this->request->is('post')) {
        $user = $this->Users->patchEntity($user, $this->request->getData());
        if ($this->Users->save($user)) {
            $this->Flash->success(__('The user has been saved.'));
            return $this->redirect(['action' => 'login']);
        } else {
            $this->Flash->error(__('The user could not be saved. Please, try again.'));
            // 替换重定向为直接渲染login视图
            return $this->render('login');
        }
    }
    $this->set(compact('user'));
}

2. 完善Login动作的实体处理 #

为了让login页面在「正常访问」和「注册失败跳转过来」两种场景下都能正常工作，需要在login动作里做兼容处理：

public function login() {
    // 如果add动作传了带错误的$user实体，就用它；否则新建空实体
    $user = $this->viewBuilder()->getVar('user') ?? $this->Users->newEntity();
    $this->set(compact('user'));
    
    // 你的其他登录逻辑代码...
}

3. 确保login.ctp的表单错误显示正常 #

CakePHP的FormHelper默认会自动在字段下方渲染错误信息，只要你的表单字段是用control方法生成的就行：

<?= $this->Form->create($user, ['url' => ['action' => 'add']]); ?>
<?= $this->Form->control('username'); ?>
<?= $this->Form->control('password'); ?>
<?= $this->Form->control('confirm_password'); // 假设你有密码确认字段 ?>
<?= $this->Form->button('注册'); ?>
<?= $this->Form->end(); ?>

如果需要手动控制错误显示位置，可以用$this->Form->error()方法：

<?= $this->Form->control('password'); ?>
<?= $this->Form->error('password'); ?>

这样修改后，当注册验证失败时，页面会停留在login视图，同时$user实体里的验证错误会正确显示在对应字段下方啦。

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