CodeIgniter4 中循环验证数据的正确方式

在 CodeIgniter4 开发过程中，开发者经常会遇到需要批量验证表单数据的情况。本文将通过一个实际案例，详细介绍如何在循环中正确使用 CodeIgniter4 的验证器进行数据验证。

问题背景

当开发者尝试在循环中使用 CodeIgniter4 的验证器验证多个数据项时，可能会遇到验证结果不符合预期的情况。这是因为验证器默认会保留上一次验证的状态，导致后续验证受到影响。

错误示范

以下是开发者最初尝试的代码示例：

foreach ($bulkData as $item) {
    // 数据预处理
    $item['server_id'] = (int) $item['server_id'];
    $item['price'] = (int) $item['price'];
    $item['stock'] = (int) $item['stock'];
    $item['stock_min'] = (int) $item['stock_min'];

    if (isset($item['enable']) && $item['enable'] == 'on') {
        // 设置验证规则
        $rules = [
            'server_id' => 'required|integer|greater_than[0]|is_not_unique[games_server.id]',
            'price' => 'required|integer|greater_than[0]',
            'stock' => 'required|integer|greater_than[0]',
            'stock_min' => 'required|integer|greater_than[0]',
        ];

        // 根据条件添加额外规则
        if ($category_id == 1) {
            $rules['delivery_method'] = 'required';
        } else {
            $rules['delivery_method'] = 'permit_empty';
        }

        if ($type == 'seller') {
            $rules['delivery_speed'] = 'required';
        }

        // 验证数据
        if (!$this->validate($rules, $item)) {
            // 处理验证错误
        }
    }
}

这段代码的问题在于，$this->validate() 方法会重用同一个验证器实例，导致验证结果不准确。

正确解决方案

要解决这个问题，我们需要在每次循环时重置验证器状态。以下是正确的实现方式：

foreach ($bulkData as $item) {
    // 数据预处理
    $item['server_id'] = (int) $item['server_id'];
    $item['price'] = (int) $item['price'];
    $item['stock'] = (int) $item['stock'];
    $item['stock_min'] = (int) $item['stock_min'];

    if (isset($item['enable']) && $item['enable'] == 'on') {
        // 设置验证规则
        $rules = [
            'server_id' => 'required|integer|greater_than[0]|is_not_unique[games_server.id]',
            'price' => 'required|integer|greater_than[0]',
            'stock' => 'required|integer|greater_than[0]',
            'stock_min' => 'required|integer|greater_than[0]',
        ];

        // 根据条件添加额外规则
        if ($category_id == 1) {
            $rules['delivery_method'] = 'required';
        } else {
            $rules['delivery_method'] = 'permit_empty';
        }

        if ($type == 'seller') {
            $rules['delivery_speed'] = 'required';
        }

        // 获取新的验证器实例并重置状态
        $validation = service('validation');
        $validation->reset();
        $validation->setRules($rules);

        // 验证数据
        if (!$validation->run($item)) {
            $results[] = [
                'status' => 'error',
                'field' => $item['server_name'],
                'message' => $validation->getErrors(),
                'data' => $item,
            ];
            continue;
        }

        // 验证通过后的处理逻辑
    }
}

关键点解析

1. 验证器实例管理：通过 service('validation') 获取验证器服务，确保每次循环使用新的验证器实例。

2. 重置验证器状态：调用 reset() 方法清除之前的验证结果和规则。

3. 设置验证规则：使用 setRules() 方法为当前验证设置新的规则。

4. 执行验证：通过 run() 方法执行验证，并获取验证结果。

替代方案

如果不想使用验证器服务，也可以采用手动验证的方式：

foreach ($bulkData as $item) {
    // 数据预处理
    $item['server_id'] = (int) $item['server_id'];
    $item['price'] = (int) $item['price'];
    $item['stock'] = (int) $item['stock'];
    $item['stock_min'] = (int) $item['stock_min'];

    if (isset($item['enable']) && $item['enable'] == 'on') {
        $errors = [];

        // 手动验证各个字段
        if (empty($item['server_id']) || $item['server_id'] <= 0) {
            $errors['server_id'] = '服务器ID必须大于0';
        }

        if (empty($item['price']) || $item['price'] <= 0) {
            $errors['price'] = '价格必须大于0';
        }

        // 其他字段验证...

        if (!empty($errors)) {
            $results[] = [
                'status' => 'error',
                'field' => $item['server_name'],
                'message' => $errors,
                'data' => $item,
            ];
            continue;
        }

        // 验证通过后的处理逻辑
    }
}

最佳实践建议

1. 验证器复用：对于简单的循环验证，推荐使用验证器服务并重置状态。

2. 性能考虑：如果验证逻辑非常简单，手动验证可能更高效。

3. 代码可读性：验证器方式更符合框架规范，代码更易于维护。

4. 错误处理：确保为每个验证失败的情况提供清晰的错误信息。

通过理解 CodeIgniter4 验证器的工作原理和正确使用方法，开发者可以更高效地处理批量数据验证场景，确保应用程序的数据完整性和安全性。