[原] 框架中增加了表单验证及表单回填功能

深藏阁楼爱情的钟 2022-01-15 09:13 197阅读 0赞

本次增强包括以下内容:

1.增加了表单项的定义功能,可以对表单项进行常规检查

2.增加了表单的定义 功能,可以对整个表单进行常规检查

3.表单项检查和表单检查中,都允许开发人员自行编写业务代码进行进一步的检查

4.使用标准的错误处理方式,将表单中的全部错误返回给前端

5.用户在表单填写过程中出现错误,再次显示表单时,数据将被回填(可选)

以下是示例代码,以登录为例

<?php
    
    use function icePHP\display;
    use function icePHP\dump;
    use function icePHP\form;
    use function icePHP\formUnit;
    
    /**
     * 示例,表单项/表单验证 及 表单回填
     * User: ice
     * Date: 2019/6/12
     * Time: 8:36
     */
    class CExam extends CBase
    {
        /**
         * 显示登录页面(即login.tpl)
         */
        public function login()
        {
            display();
        }
    
        /**
         * 私有方法,生成一个表单项
         * @return icePHP\FormUnit
         */
        private function unitLoginCheck()
        {
            //定义表单项的英文名称和中文名称以及验证规则
            $unit = formUnit('checkCode', '验证码')
                ->minLength(4, '验证码必须是4位')
                ->maxLength(4, '验证码必须是4位');
    
            //这一段用于开发人员自行编写检查代码
            if (!$unit->check()) { //如果之前的验证通过
                //这里是示例的检查逻辑
                if ($unit->value() != '1234') {
                    $unit->error('开发人员对验证码进行检查时发现错误');
                }
            }
    
            return $unit;
        }
    
        /**
         * 私有方法,生成一个表单对象
         * @return icePHP\Form
         */
        private function formLogin()
        {
            //定义一个表单对象所包含的表单项
            $form= form('登录')->add(
                formUnit('name', '姓名')->must()->minLength(2, '姓名必填'),
                formUnit('password', '密码')->must()->minLength(6, '密码太短'),
                formUnit('age', '年龄')->min(18, 'Too Young')->max(70, 'Too Old'),
                $this->unitLoginCheck()
            );
    
            //这一段用于开发人员自行编写检查代码
            if(!$form->check()){ //如果之前的验证通过
                //取表单数据
                $data=$form->value();
    
                //对表单数据进行进一步检查
                if($data['checkCode']!='1234'){
                    $form->error('开发人员对表单进行检查时发现错误');
                }
            }
    
            return $form;
        }
    
        /**
         * 登录后的提交处理
         */
        public function loginSubmit()
        {
            //生成表单对象
            $form = $this->formLogin();
    
            //整个表单进行检查
            $error = $form->check();
    
            //如果有错误,报错
            if ($error) {
                $this->error($error);
            }
    
            //取出表单的值
            $value = $form->value();
    
            //进行下一步业务处理
            dump($value);
        }
    }