drupal7之学习在已存在的form表单中增加自定义验证(Learn how to add custom validation to an existing Drupal form)

注:原文链接:http://befused.com/drupal/form-validation(翻译水平有限,还望海涵)
start:
表单验证是web系统中必不可少的一部分,你需要确保用户输入的信息是否是可取的,如果不可取会反馈错误信息
感谢Drupal钩子,你可以简单的在任何一个表单中增加验证,即使你并没有创建这个表单。在这个教程里面,你会学习怎样用验证函数去验证一篇文章表单,增加一篇文章的的地址在这里 node/add/article
示例你要确保用户不能增加这个标题打的文章:” the quick fox jumped over the lazy dog”,如果写下了这个标题,则返回一个错误信息。
在这个教程中,你可能需要下载和开启一个叫devel的开发神器来打印消息(dpm函数)。

Alter the form

增加一个新的验证函数,你需要去alter下这个表单(至于为什么我不细讲了,就是重写下表单)如果看不懂看完这里应该就会了(
○17天开始模块开发(http://befused.com/drupal/form-alter)
○23天开始模块开发。(http://befused.com/drupal/first-module)

OK,我们开始吧

1
2
3
4
5
6
7
8
9
10
11
12
13
14
1.	function starting_drupal_dev_form_alter(&$form, &$form_state, $form_id) {
2. if ($form_id == 'article_node_form') {
3. dpm($form['#validate']);
4. }
5. }

```从上面代码可以看到,我们第一步判断form的ID是否是acticle_node_form,然后用dpm($form[‘#validate’]),。它列出了所有的验证函数。
当你点击进/node/add/acticle页面,你可以看见node_form_validate(),
![这里写图片描述](http://img.blog.csdn.net/20150406223536156)

增加一个验证处理的handler(这个词一下子不知道怎么翻译了)
--------------------------------
你需要增加一个验证函数到$form[‘#validate’]这个数组里面
函数名:’ starting_drupal_dev_form_validate’
  1. function starting_drupal_dev_form_alter(&$form, &$form_state, $form_id) {
  2. if ($form_id == ‘article_node_form’) {
  3. $form[‘#validate’][] = ‘starting_drupal_dev_form_validate’;
  4. dpm($form[‘#validate’]);
  5. }
  6. }
node_form_validate是其中的一个![这里写图片描述](http://img.blog.csdn.net/20150406223756947)
1
2
创建一个验证函数:
现在你需要增加一个回调函数starting_drupal_dev_form_validate()
  1. function starting_drupal_dev_form_validate($form, &$form_state) {
  2. }
    当表单被提交后,这个表单的值存放在$form_state里面,你可以打印出来看一看`
1
2
3
4
5
6
7
8
1.	function starting_drupal_dev_form_validate($form, &$form_state) {
2. dpm($form_state);
3. }

![这里写图片描](http://img.blog.csdn.net/20150406223933807)
找到你需要的字段。$form_state[‘values’][’title’]
如果这个值为“the quick fox jumped over the lazy dog”就返回一个错误
![这里写图片描述](http://img.blog.csdn.net/20150406223959660)
  1. function starting_drupal_dev_form_validate($form, &$form_state) {
  2. if ($form_state[‘values’][‘title’] == ‘the quick fox jumped over the lazy dog’) {
  3. form_set_error(‘title’, t(‘You have added an invalid title.’));
  4. }
  5. }

**

1
2


if ($form_state[‘values’][‘title’] == ‘the quick fox jumped over the lazy dog)
这里是一个简单的判断函数
如果它的值是the quick fox jumped over the lazy dog它将返回真
然后里面的代码将会被执行

1
form_set_error('title', t('You are not allowed to use "the quick fox jumped over the lazy dog" as a title.')

这里写图片描述

验证多种标题

现在我们来试着用两个值进行验证。第二个值就取:“birds of a feather flock together”

1
2
3
4
5
6
1.	function starting_drupal_dev_form_validate($form, &$form_state) {
2. $invalid_titles = array('the quick fox jumped over the lazy dog', 'birds of a feather flock together');
3. if (in_array($form_state['values']['title'], $invalid_titles)) {
4. form_set_error('title', t('You have added an invalid title.'));
5. }
6. }

拆分来看看吧

1
$invalid_titles = array('the quick fox jumped over the lazy dog', 'birds of a feather flock together');

首先,我们创建了一个需要判断标题的数组

1
if (in_array($form_state['values']['title'], $invalid_titles)) { .. }

接下来我们判断标题值是否等于数组里面任何一个成员

OK,教程到此结束,相信你应该也会使用验证函数了吧,
没错,这就是一个简单的验证函数。