API CodeIgniter 中的表单验证输入

CodeIgniter 是一个流行的 PHP 框架，提供了丰富的功能和工具，其中包括表单验证输入的功能。在开发 API 时，表单验证输入非常重要，可以帮助我们避免错误的请求和数据，提高可靠性和安全性。

在 CodeIgniter 中，表单验证输入的功能主要通过 Form Validation 类实现。该类提供了大量的方法和规则，可以满足各种验证需求，如验证必填字段、验证数值范围、验证邮箱格式、验证密码复杂度等。

配置表单验证输入

首先需要配置表单验证输入，在 application/config 目录下的 form_validation.php 文件中进行配置。这里可以设置默认的规则和错误提示信息等。

$config = array(
    'register' => array(
        array(
            'field' => 'username',
            'label' => 'Username',
            'rules' => 'required|min_length[5]|max_length[20]',
            'errors' => array(
                'required' => 'Username is required!',
                'min_length' => 'Username must be at least 5 characters long!',
                'max_length' => 'Username cannot be more than 20 characters long!'
            )
        ),
        array(
            'field' => 'password',
            'label' => 'Password',
            'rules' => 'required|min_length[8]|max_length[20]',
            'errors' => array(
                'required' => 'Password is required!',
                'min_length' => 'Password must be at least 8 characters long!',
                'max_length' => 'Password cannot be more than 20 characters long!'
            )
        ),
        array(
            'field' => 'email',
            'label' => 'Email',
            'rules' => 'required|valid_email',
            'errors' => array(
                'required' => 'Email is required!',
                'valid_email' => 'Email must be a valid email address!'
            )
        ),
    ),
);

这里设置了一个 register 表单的验证规则，包括了 username、password 和 email 三个字段，分别设置了字段名、标签名、验证规则和错误提示信息。

执行表单验证输入

在控制器中执行表单验证输入的过程非常简单，只需要调用 Form Validation 类的 run 方法即可。

$this->load->library('form_validation');

// load the rules for the register form
$this->config->load('form_validation');
$this->form_validation->set_rules($this->config->item('register'));

if ($this->form_validation->run() === TRUE) {
    // validation successful
    // do your logic here
} else {
    // validation failed
    // display error message
    $data['errors'] = validation_errors();
}

这里首先加载了 Form Validation 类和之前配置的验证规则。然后使用 set_rules 方法设置要验证的字段和规则，使用 run 方法执行验证操作。如果验证成功，就可以执行自己的逻辑；如果验证失败，则可以显示错误信息，使用 validation_errors 获取所有的错误信息。

自定义表单验证规则

有时候，自带的验证规则无法满足我们的需求，这时我们需要使用自定义规则。CodeIgniter 提供了 set_rules 和 set_data 方法，让我们可以轻松地自定义验证规则，如下所示：

$this->form_validation->set_data(array(
    'password' => $password,
    'confirm_password' => $confirm_password
));
$this->form_validation->set_rules('password', 'Password', 'min_length[8]|max_length[20]|matches[confirm_password]');
$this->form_validation->set_rules('confirm_password', 'Confirm Password', 'required');

这里使用 set_data 方法设置了密码和确认密码两个字段的值，然后使用 set_rules 方法设置了两个验证规则。其中包括了自定义的规则 matches[confirm_password]，表示验证两次密码是否相同。

总结

在开发 API 时，表单验证输入非常必要，可以有效保障数据的可靠性和安全性。CodeIgniter 提供的 Form Validation 类提供了丰富的验证规则和方法，简单易用，可以帮助我们快速实现表单验证输入的功能。如果有自定义规则的需求，也可以轻松自定义规则，达到更好的验证效果。