CakePHP 4-如何验证需要将数据保存到多个表的表单

CakePHP 4 是一个流行的 PHP 框架，它提供了强大的工具来简化 Web 应用程序的开发过程，包括表单验证和多表数据保存。以下是如何在 CakePHP 4 中验证并将数据保存到多个表的步骤：

基础概念

在 CakePHP 中，表单验证通常是通过模型（Model）来完成的，模型代表了数据库中的一个表，并包含了与该表相关的逻辑。CakePHP 提供了一套验证规则，可以很容易地定义在模型中。

类型

CakePHP 支持多种验证类型，包括：

required：字段必须填写。
minLength / maxLength：字段长度的限制。
pattern：正则表达式匹配。
numeric：必须是数字。
等等。

应用场景

当你有一个表单需要提交数据到多个相关联的表时，例如用户注册表单，可能需要同时保存用户信息和用户配置信息到不同的表中。

如何实现

假设我们有两个表：Users 和 UserProfiles，我们需要验证并将数据保存到这两个表中。

步骤 1：定义模型关系

首先，在 Users 模型中定义与 UserProfiles 的关系：

// src/Model/Table/UsersTable.php
namespace App\Model\Table;

use Cake\ORM\Table;

class UsersTable extends Table
{
    public function initialize(array $config): void
    {
        $this->hasOne('UserProfiles');
    }
}

步骤 2：设置验证规则

在 Users 和 UserProfiles 模型中设置验证规则：

// src/Model/Table/UsersTable.php
namespace App\Model\Table;

use Cake\Validation\Validator;

class UsersTable extends Table
{
    // ...

    public function validationDefault(Validator $validator): Validator
    {
        $validator
            ->notEmpty('username')
            ->add('username', 'unique', ['rule' => 'validateUnique', 'message' => 'This username has already been taken.']);

        $validator
            ->notEmpty('email')
            ->add('email', 'unique', ['rule' => 'validateUnique', 'message' => 'This email has already been taken.']);

        return $validator;
    }
}

// src/Model/Table/UserProfilesTable.php
namespace App\Model\Table;

use Cake\Validation\Validator;

class UserProfilesTable extends Table
{
    public function validationDefault(Validator $validator): Validator
    {
        $validator
            ->notEmpty('first_name')
            ->notEmpty('last_name');

        return $validator;
    }
}

步骤 3：保存数据到多个表

在控制器中，使用 saveAssociated 方法来保存关联的数据：

// src/Controller/UsersController.php
namespace App\Controller;

use App\Model\Table\UsersTable;
use Cake\Http\Exception\BadRequestException;
use Cake\Http\Response;
use Cake\Http\ServerRequest;

class UsersController extends AppController
{
    public function add(ServerRequest $request, Response $response): Response
    {
        $user = $this->Users->newEmptyEntity();
        if ($this->request->is('post')) {
            $user = $this->Users->patchEntity($user, $request->getData(), [
                'associated' => ['UserProfiles']
            ]);

            if ($this->Users->saveAssociated($user)) {
                return $response->withStatus(201)->withStringBody('User created successfully.');
            }

            throw new BadRequestException('There were validation errors.');
        }

        $this->set('user', $user);
    }
}