跳转到主要内容
yoqu 提交于 6 April 2015

注:原文链接: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下这个表单(至于为什么我不细讲了,就是重写下表单)如果看不懂看完这里应该就会了

OK,我们开始吧。

function starting_drupal_dev_form_alter(&$form, &$form_state, $form_id) {
  if ($form_id == 'article_node_form') {
    dpm($form['#validate']);
  }
} 

从上面代码可以看到,我们第一步判断form的ID是否是acticle_node_form,然后用dpm($form[‘#validate’]),。它列出了所有的验证函数。

当你点击进/node/add/acticle页面,你可以看见node_form_validate()。

这里写图片描述

增加一个验证处理的handler(这个词一下子不知道怎么翻译了)

你需要增加一个验证函数到$form[‘#validate’]这个数组里面,函数名:’ starting_drupal_dev_form_validate’

function starting_drupal_dev_form_alter(&$form, &$form_state, $form_id) {
  if ($form_id == 'article_node_form') {
    $form['#validate'][] = 'starting_drupal_dev_form_validate';
    dpm($form['#validate']);
  }
} 

你现在可以在打印机上看见这里有两个验证handlers.核心的 node_form_validate是其中的一个!

validate_array_with_new.png

创建一个验证函数:现在你需要增加一个回调函数starting_drupal_dev_form_validate()。

这里写代码片

function starting_drupal_dev_form_validate($form, &$form_state) {   }

当表单被提交后,这个表单的值存放在$form_state里面,你可以打印出来看一看

function starting_drupal_dev_form_validate($form, &$form_state) {
  dpm($form_state);
}

这里写图片描

找到你需要的字段。$form_state[‘values’][’title’],如果这个值为“the quick fox jumped over the lazy dog”就返回一个错误。

这里写图片描述

function starting_drupal_dev_form_validate($form, &$form_state) {
  if ($form_state['values']['title'] == 'the quick fox jumped over the lazy dog') {
    form_set_error('title', t('You have added an invalid title.'));
  }
}

**我们先分析下上面的函数**

if ($form_state['values']['title'] == 'black') { … }

这里是一个简单的判断函数,如果它的值是the quick fox jumped over the lazy dog它将返回真 ,然后里面的代码将会被执行。

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

validation_error.png

验证多种标题

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

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

拆分来看看吧

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

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

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

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

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

Drupal 版本