對喜愛 PHP 的人來說,心裡往往藏著一個更大的期待:讓 PHP 有能力扛起大型系統的架構,直到有一天,企業級方案在挑選框架時也會認真考慮 PHP。
話雖如此,我們也得坦白承認,PHP 天生帶著腳本語言的基因,這樣的願望多少顯得有些奢侈。但只要肯下功夫,努力終究會開花結果。
這個公共套件最大的好處,就是讓我們的程式碼變得乾淨,不再讓 HTML 標籤和程式邏輯攪成一團。而它更值得深挖的能力,還在前面等著我們。毫無疑問,它最直接的用途就是快速搭建表單(Form)。
程式碼一:
require_once("Html/QuickForm.php");
//建立一個表單物件,指定表單名稱與提交方式
$form = new Html_QuickForm('fmJyxx','post');
//為表單加上一個標題
$form->addElement('header', 'title','標題');
//新增一個 select 控制項,名稱為 field1,Label 為「字段1:」,下拉選項有 s1、s2,對應的值為 "1" 與 "2"
$form->addElement('select', 'field1', '字段1:',array("1"=>"s1","2"=>"s2"));
//新增一個 text 控制項
$form->addElement('text', 'field2', '字段2:');
//以上新增的 Element 依預設模板是上下排列,接著把兩個按鈕排在同一列加進去
$group[] =& Html_QuickForm::createElement('submit', 'tj', '提交');
$group[] =& Html_QuickForm::createElement('reset', 'cz', '重置');
$form->addGroup($group, 'buttons', '功能按鈕:', ' ');
寫到這裡,表單就算搭好了,只要呼叫 $form->display() 就能把它渲染出來。你會發現 PHP 正一點一點把 HTML 標籤從我們的程式碼裡淡化掉,讓我們能像寫 Java、C++ 那樣專心於邏輯本身,而不必再為標籤的排列傷透腦筋。
QuickForm 還內建了控制項資料的驗證功能,規則相當豐富,也支援擴充。舉例來說,若你要求 field2 必填:
$form->addRule("field2","字段2 不能為空",'required','','client');
各參數依序為:要驗證的控制項名稱、驗證未通過時的提示訊息、規則名稱(此處為必填),以及 client——代表可把規則轉換成客戶端的 JavaScript 程式碼。
假設有個 field3,你想為它自訂一條特殊規則,可以這樣做。先註冊一條規則:
$form->registerRule('ckdate','function','mycheckdate');
參數分別是:規則名稱、驗證方式(此處為函式),以及函式名稱 mycheckdate。接著你只要定義 mycheckdate 函式即可,系統會自動把 field3 的值當成參數傳進來:
function mycheckdate($val){
}
最後回傳 true 或 false,就能表達你對這個值的驗證結果。
了解了如何建構表單,接下來要思考的是:建好之後,該怎麼操作這些控制項?
QuickForm 是一整套體系,它提供了 HTML_QuickForm_Element 類別作為所有控制項的基底類別;透過繼承這個基底,我們就有了各種具體控制項的類別,例如 Html_QuickForm_Select。每個具體類別都有各自不同的屬性與操作方法,比方說 Text 只需要 getValue 與 setValue,而 Select 還得處理 Options 相關的操作,像 addOption 函式就是一例。
完成前述程式碼後,我們可以這樣取得某個控制項:
$elem = $form->getElement("elementname");
此時 $elem 就是名稱為 "elementname" 之控制項的參照指標,透過它,你就能對該具體類別的屬性進行讀寫。每個控制項都對應一個類別,詳細資訊請參考 PEAR 手冊的 HTML_QuickForm 章節。(註:我在實作這部分時曾遇到失效的狀況,也期待早日弄清箇中原由。)
我們常見的身份驗證,需要一個包含使用者名稱與密碼輸入的表單,這個表單可以由 QuickForm 來建構,而認證方式則可交給另一個 PEAR 套件——Auth 來完成。
程式碼二:
//使用者名稱與密碼的表單程式碼沿用前述 QuickForm 的寫法,包在函式 show_form 中,此處從略
//...........
//此驗證方式基於資料庫,範例中的資料庫是本機 MySQL 下的 mydb,
//建立的關聯表為 auth,欄位為 username 與 password,密碼加密方式設為 "none" 表示未加密
require_once("AUTH/AUTH.php");
//連線參數
$options = array(
"dsn" => "mysql://caoxh:jiziba@localhost/mydb",
"table" => "auth",
"usernamecol" => "username", //使用者名稱欄位
"passwordcol" => "password", //口令欄位
"cryptType" => "none", //口令加密方式,明文驗證則為 'none'
);
//全域的認證變數
$au = new Auth('DB',$options,'show_form');
$au->setExpire(10);
$auth->start();
if(!$auth->getAuth()){
exit('system deny the user!');
}
//Auth 會把表單顯示出來並進行認證,把 $au 設為全域變數後,你日後就能透過 $au 的方法來判斷認證資訊。