Haohappy 2005-12-28
http://blog.csdn.net/Haohappy2004
Haohappy 在《 PHP & More 》第三期的 《 PEAR::HTML_QuickForm 入門 》 一文中 說過要寫 QuickForm 和 Smarty 的結合應用，一直沒寫，今天看到 PHPE 論壇上有朋友在詢問，為自己的懶惰而慚愧。現在補上，希望對大家有點幫助。 在我看來， PEAR::HTML_QuickForm 是個非常優秀的表單類庫，大大加快了開發速度，我現在的大多數項目都會用到。 如果對 PEAR::HTML_QuickForm 不了解的朋友，建議先看這篇文章。
本文針對的讀者為有較豐富開發經驗的 PHP 程序員，要求讀者
<!--[if !supportLists]--> 1． <!--[endif]--> 熟悉 PEAR 及其安裝和使用；
<!--[if !supportLists]--> 2． <!--[endif]--> 熟悉 HTML_QuickForm ；
<!--[if !supportLists]--> 3． <!--[endif]--> 理解模板的概念，熟悉 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
);
//buildtheHTMLfortheform
生成表單的
HTML
代碼
$form
->
accept
(
$renderer
);
//assignarraywithformdata
分配表單數據到數組中
$smarty
->
assign
(
'form_data'
,
$renderer
->
toArray
());
$smarty
->
catching
=
false
;
//
調試
//echo"<pre>";var_dump($renderer->toArray());echo"</pre>";
$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"<pre>";var_dump($renderer->toArray());echo"</pre>";
這一行用來調試，我們隨時可以把
$renderer
中的所有變量打印出來，看看程序是否執行正確。
再看我們的模板，也很簡單：
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<TITLE> changePwd.tpl </TITLE>
<<place w:st="on">META</place> NAME="Generator" CONTENT="EditPlus">
<<place w:st="on">META</place> NAME="Author" CONTENT="Haohappy">
<<place w:st="on">META</place> NAME="Keywords" CONTENT="">
<<place w:st="on">META</place> NAME="Description" CONTENT="">
<link href="{$CSSDIR}/style.css" rel="stylesheet" type="text/css">
{if $form_data.javascript}
{$form_data.javascript}
{/if}
</HEAD>
<BODY>
<p> </p>
<p> </p>
<p> </p>
<form {$form_data.attributes} >
<table width="300"
border="0" align="center" cellpadding="3" cellspacing="3" bgcolor="#F6F6F6" style="font-size:9pt" class="AddTable">
<tr bgcolor="#FFFFFF">
<td width="47%" colspan="2"><div align="center">
修改管理員密碼
</div></tr>
<tr>
<tr>
<td width="47%"><div align="center">
現有管理員密碼
</div></td>
<td width="53%">{$form_data.adminPwd.html}</td>
</tr>
<tr>
<td><div align="center">
新密碼
</div></td>
<td>{$form_data.newPwd.html}</td>
</tr>
<tr>
<td><div align="center">
再次輸入新密碼
</div></td>
<td>{$form_data.newPwd2.html}</td>
</tr>
<tr>
<td colspan="2"><div align="center">
{$form_data.btnSubmit.html}
</div></td>
</tr>
</table>
</form>
</BODY>
</HTML>
這兩個簡單的文件，總共不到 100 行代碼，就完成了我們在文章開頭的效果。包含完整的表單數據驗證，處理過程。
另：使用 QuickForm ，可以很方便地實現顯示層和邏輯層的分離，因為處理的函數是完全獨立出來的。
例如說可以把
if(
$form
->
validate
()){
//
如果表單數據正確，修改密碼
$form
->
process
(
'changePwd'
);
}
<!--[if !supportLineBreakNewLine]-->
<!--[endif]-->
改裝成
if(
$form
->
validate
()){
switch ($post_vars['action']) {
default:
case "changPwd":
$form
->
process
(
'changePwd'
);
break;
case "Add":
$form
->
process
(
'add'
);
break;
case "Update":
$form
->
process
(
'update'
);
break;
case "Delete":
$form
->
process
(
'delete'
);
break;
}
<!--[if !supportLineBreakNewLine]-->
<!--[endif]-->
然后把 changePwd,add,update,delete 四個函數獨立到某個文件當中。這樣就可以根據頁面提交的 action 來調用不同的操作。
這個想法相對比較簡陋一些，如果你要用更強大的功能，還可以試試 PEAR:: HTML_QuickForm_Controller 。 HTML_QuickForm_Controller 基于 PageController 設計模式 ，也就是用單個頁面來處理通過 GET 和 POST 傳遞而來的 request 和 action 。這是個非常有意思的想法，但是這種開發模式不適合于新手，因為相對比較復雜。其作者也說：
HTML_QuickForm_Controller is not intended for PHP newbies. If you don't understand what classes are, if you have no prior experience with QuickForm, if you are a fan of copy-paste programming then this package is not for you.
The package is indeed complex, but so are the problems it is trying to solve. Try to rewrite any of the enclosed multipage form examples without using such a package and you'll see what we mean.
這部份暫不討論，這需要大家對MVC有一定了解，下次有機會再另寫文章。我自己目前的開發框架就是個MVC框架，覺得很順手，顯示部份就是
更多文章、技術交流、商務合作、聯系博主
微信掃碼或搜索：z360901061
微信掃一掃加我為好友
QQ號聯系： 360901061
您的支持是博主寫作最大的動力，如果您喜歡我的文章，感覺我的文章對您有幫助，請用微信掃描下面二維碼支持博主2元、5元、10元、20元等您想捐的金額吧，狠狠點擊下面給點支持吧，站長非常感激您！手機微信長按不能支付解決辦法：請將微信支付二維碼保存到相冊，切換到微信，然后點擊微信右上角掃一掃功能，選擇支付二維碼完成支付。
【本文對您有幫助就好】元
