注:原文链接: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下这个表单(至于为什么我不细讲了,就是重写下表单)如果看不懂看完这里应该就会了
- 7天开始模块开发(http://befused.com/drupal/form-alter)
- 3天开始模块开发。(http://befused.com/drupal/first-module)
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是其中的一个!
创建一个验证函数:现在你需要增加一个回调函数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.'));
验证多种标题
现在我们来试着用两个值进行验证。第二个值就取:“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,教程到此结束,相信你应该也会使用验证函数了吧,没错,这就是一个简单的验证函数。