Solar的表单、过滤器示例

• Solar的表单、过滤器示例
  • Model过滤器与form过滤器的区别
  • Form过滤器
    • 配置自定义filter类 config.php
    • 源码：actionLogin()
    • 自定义Filter的Locale文件en_US.php

Model过滤器与form过滤器的区别

• 用途不一样

Model过滤器主要用于数据的添加与修改上，而form过滤器则主要用于数据的查询上。

• 验证方法不一样

在actionRegister()中，我们通过$this->item->save()来存储数据到数据库中, 在插入数据库之前就会根据Model中和action中添加的过滤器验证数据。

在Form中，我们要通过form的方法Solar_Form::populate()来取得数据再执行Solar_Form::validate()来验证数据。

Form过滤器

配置自定义filter类 config.php

$config['Solar_Filter'] = array( 'classes' => array('Admin_Filter'),);

注意在使用Form添加自定义的Filter时必须要指定在哪里找你写的Filter，不然Solar找不到。在使用Model添加Filter时不需指定。

源码：actionLogin()

public function actionIndex(){ // 表单对象 $this->form = Solar::factory('Solar_Form'); // 构造表单 $elements = array( 'handle' => array( 'label' => '用户名', 'type' => 'input', 'filters' => array('validateNotBlank', 'validateWord'), ), 'passwd' => array( 'label' => '密码', 'type' => 'password', 'filters' => array('validateNotBlank'), ), ); $this->form->setElements($elements, 'user'); // 添加filter $this->form->addFilter('user[passwd]', 'validateMobile'); // 提交 if($this->_isProcess('logins')) { // 验证数据 $this->form->populate(); $this->form->setFilterLocaleObject(Solar::factory('Admin_Filter')); // 设置验证数据的本地化字符串类 $this->form->validate(); // 得到数据 $data = $this->_request->post('user'); $user = $this->_model->users->fetchOne(array( 'where' => array('handle = ? ' => $data['handle'], 'passwd = ? ' => md5($data['passwd']) ))); // 是否有该用户 if($user) { $this->form->feedback = '恭喜你，登录成功！'; // 设置feedback，默认为 Saved 或 Not Saved... } else { // 设置表单的状态为false $this->form->setStatus(false); // 只为class = failure，写CSS时有用！ $this->form->feedback = '对不起，你输入的用户名或密码错误，请重新输入'; } } }

说明$this->form对象有一个protected的属性$_status，它的值有两个:ture or false, 当为ture时，$this->form的feedback默认为Saved, 当为fase时，它的feedback默认为Not Saved....，那么Solar_Form::$_status的值什么时候改变呢？

当$this->form->validate()验证失败时，设$this->form->$_status = false，否则设为true。

当验证失败时，会将invalid信息存储到表单元素的invalid属性中, 这样就可以在view中输出form时把invalid信息一起输出来供用户参考。具体的输出形式请看HTML源码。这样可以根据该信息写特定的CSS CLASS。

当数据验证无误时且无该用户时，我们使用$this->form->setStatus(false)使form的状态为false，这行代码只为前台写CSS时有用，因为数据验证无误form的status=true，而用户又不存在，所以要特地设状态为false。

因为$this->form->addFilter('user[passwd]', 'validateMobile')，我们使用了自定义的filter，所以要找到/Admin/Filter/Locale/en_US.php文件中设置的本地字符串，必须使用$this->form->setFilterLocaleObject(Solar::factory('Admin_Filter'))来设置本地字符串转换对象以告诉Solar在哪里找本字化字符串。

自定义Filter的Locale文件en_US.php

return array( 'INVALID_MOBILE' => '手机号码有误！');