PEAR::HTML_QuickFormとSmartyの組み合わせアプリケーション

　　Haohappy在《PHP & More》第三期的《PEAR::HTML_QuickForm入门》一文中说过要写QuickForm和Smarty的结合应用，一直没写，今天看到PHPE论坛上有朋友在询问，为自己的懒惰而惭愧。现在补上，希望对大家有点帮助。 在我看来，PEAR::HTML_QuickForm是个非常优秀的表单类库，大大加快了开发速度，我现在的大多数项目都会用到。如果对PEAR::HTML_QuickForm不了解的朋友，建议先看这篇文章。

　　本文针对的读者为有较丰富开发经验的PHP程序员，要求读者

1．             熟悉PEAR及其安装和使用；

2．             熟悉HTML_QuickForm；

3．             理解模板的概念，熟悉Smarty模板引擎的使用。

　　在《PEAR::HTML_QuickForm入门》的表单的美化输出一节中，提到了用QuickForm自带的Form修饰方法来美化输出。很明显，这种方法显得有点麻烦，而且让程序员来美化网页，有点难为我们了。 现在程序员和设计师的合作最常见的就是通过模板，所以如何把QuickForm和模板引擎相结合，这就是我们需要解决的问题。其实QuickForm可以和多种模板引擎相结合，如ITX, Sigma, Flexy, Smarty等，每种模板都有其优点和缺点，目前Smarty是最通用的模板引擎，所以我们把QuickForm和Smarty的结合作为重点来研究。

　　首先，给大家看看我们的最后效果：

　　这个例子非常简单，只有一个Form，4个Input，只是用来讲解QuickForm的使用。在实际开发中，我们经常遇到几十个Input的情况。实际上，表单越复杂，就越显出我们传统的处理方式的低效，就越显出QuickForm的强大。这一点，也许大家以后会体会到。

好，开始我们的QuickForm+Smarty之旅。

changPwd.php

require_once("includes/config.inc.php");
//构建Smarty对象
$smarty = new Smarty_App;
$smarty->assign('CSSDIR','./templates/admin');
$smarty->assign('title',':: Haohappy Test网站管理系统 ::');

//构建登录表单
$form = new HTML_QuickForm('frmChgPwd', 'post');

//增加表单元素
$form->addElement('password', 'adminPwd', '','class = NameAndPwd');
$form->addElement('password', 'newPwd', '','class = NameAndPwd');
$form->addElement('password', 'newPwd2', '','class = NameAndPwd');
$form->addElement('submit', 'btnSubmit', '修改密码','class = btnSubmit');

//增加验证规则 会自动生成javascript变量，存入javascript验证函数
$form->addRule('adminPwd','密码不能为空！', 'required','','client'); 
$form->addRule('newPwd','新密码不能为空！', 'required','','client'); 
$form->addRule('newPwd2','新密码不能为空！', 'required','','client'); 
$form->addRule(array('newPwd','newPwd2'),"两次输入的密码不同！！",'compare','','client');

if ($form->validate()) {
        //如果表单数据正确，修改密码
        $form->process('changePwd');
}
else{

  //否则显示表单

 // 建立renderer对象
 $renderer =& new HTML_QuickForm_Renderer_ArraySmarty($smarty );    
 
 // build the HTML for the form 生成表单的HTML代码
 $form->accept($renderer);

 //assign array with form data 分配表单数据到数组中
 $smarty->assign('form_data', $renderer->toArray());
 $smarty->catching = false;

 // 调试
 //echo "

";var_dump($renderer->toArray());echo "

";
 $smarty->display("changePwd.tpl");

}

//修改密码
function changePwd(){}     
?>

　　在代码中，我们用$form->addElement()增添了4个表单元素，用$form->addRule()增加了4条验证规则。怎么样，是不是很快捷方便？ 以验证两个密码是否相同的验证规则为例，如果我们自己写验证规则，虽然快，但是代码就会显得臃肿和凌乱，由QuickForm来负责数据验证，开发速度大大提高，而且代码显得很简洁漂亮。仅用了一行代码：

$form->addRule(array('newPwd','newPwd2'),"两次输入的密码不同！！",'compare','','client');

　　关于QuickForm的好处，请参看《PEAR::HTML_QuickForm入门》，在此不再重复。

　　下面这行代码就是我们将HTML_QuickForm与Smarty连接的桥梁：

$renderer =& new HTML_QuickForm_Renderer_ArraySmarty($smarty );

　　所谓renderer，就是用来负责显示的，这里我们把QuickForm的renderer指定为Smarty，我们就可以使用强大的Smarty模板引擎来格式化QuickForm的输出了。

　　其它：

changePwd()是这个文件的核心操作函数，用来修改密码。

$form->process('changePwd');  //这行代码用来调用changePwd()

//echo "

";var_dump($renderer->toArray());echo "

";

　　这一行用来调试，我们随时可以把$renderer中的所有变量打印出来，看看程序是否执行正确。

　　再看我们的模板，也很简单：

{if $form_data.javascript}

    {$form_data.javascript}

{/if}

 

 

 

 

 

 

   

   

 

 

   

   

 

 

   

   

 

 

   

修改管理员密码
现有管理员密码	{$form_data.adminPwd.html}
新密码	{$form_data.newPwd.html}
再次输入新密码	{$form_data.newPwd2.html}
{$form_data.btnSubmit.html}

これら 2 つの単純なファイルは、合計 100 行未満のコードで、記事の冒頭の効果を完成させます。完全なフォーム データの検証と処理が含まれます。

もう 1 つ: QuickForm を使用すると、処理機能が完全に独立しているため、表示層とロジック層を簡単に分離できます。

たとえば、

if ($form->validate()) {
'changePwd');
}
<-- [if !supportLineBreakNewLine]-->

に変更されました

if ($form->validate()) {

switch ($post_vars['action']) {

デフォルト: changPwd":

$form->process('changePwd');

ブレーク;

case "追加":

$form-> ;process('add');

ブレーク;

ケース "更新":

$form->process('update');

}

次に、changePwd、add、update、delete の 4 つの関数を特定のファイルに分割します。このようにして、ページによって送信されたアクションに基づいてさまざまな操作を呼び出すことができます。

このアイデアは比較的単純です。より強力な関数を使用したい場合は、

PEAR::HTML_QuickForm_Controller を試すこともできます。 HTML_QuickForm_Controller は PageController デザイン パターンに基づいており、単一のページを使用して GET および POST で渡されるリクエストとアクションを処理します。これは非常に興味深いアイデアですが、この開発モデルは比較的複雑であるため、初心者には適していません。その作成者は次のようにも述べています:

HTML_QuickForm_Controller は、クラスが何なのかを理解していない場合、QuickForm の経験がない場合、コピーアンドペースト プログラミングのファンである場合は、これを使用してください。

このパッケージは確かに複雑ですが、解決しようとしている問題も同様です。そのようなパッケージを使用せずに、囲まれた複数ページのフォームの例を書き換えてみるとわかります。

この部分については、当面は説明しません。これには、全員が MVC について一定の理解を持っている必要があります。次回機会があれば別の記事を書きます。現在の開発フレームワークは MVC フレームワークで、表示部分は Smarty+QuickForm で完結します。より多くの人に QuickForm に注目して使ってもらいたいと願っています。きっと、使ってみてがっかりすることはないと思います

。