譯者按:xajax 最大的特色在於它以 XML response 為核心,讓我們可以用 PHP 來安排「異步取得資料之後如何更新網頁內容」這件事。其他 Ajax 框架多半得靠 JavaScript 自己寫回呼處理,而 xajax 只需要寫幾個 PHP 函數就能搞定。想學好 xajax,關鍵是把 xajaxresponse 類用熟。
教程:十分鐘學會 xajax
載入 xajax 類庫:
require_once("xajax.inc.PHP");
建立 xajax 物件:
$xajax = new xajax();
註冊你希望透過 xajax 呼叫的 PHP 函數(它會對應到一個同名的 JavaScript 函數,例如 xajax_myfunction):
$xajax->registerFunction("myfunction");
接著實作剛才註冊的函數,並用 xajaxresponse 物件回傳 XML 指令:
function myfunction($arg)
{
// 依 $arg 做些事情,例如從資料庫取資料並存入 $newcontent
$newcontent = ...
// 建立 xajaxresponse 物件
$objResponse = new xajaxresponse();
// 加入一道指令:把 id 為 someelementid 的元素 innerHTML 換成新內容
$objResponse->addAssign("someelementid","innerHTML", $newcontent);
// 回傳 xajaxresponse 產生的 XML
return $objResponse->getXML();
}
在腳本輸出任何內容之前,先讓 xajax 攔截並處理請求:
$xajax->processRequests();
在 <head> 區塊中,讓 xajax 產生所需的 JavaScript:
<?php $xajax->printJavascript(); ?>
最後,從 JavaScript 事件或函數中呼叫你註冊過的函數:
<div id="someelementid"></div>
<button onclick="xajax_myfunction('...')">按我</button>
就這樣。其餘的都交給 xajax。你真正要花力氣的,只剩下寫 PHP 函數並回傳 xajax 的 XML 回應——而這一步靠 xajaxresponse 類變得非常輕鬆。
xajax 最與眾不同的地方,就在 xajaxresponse 類。別的 Ajax 函式庫要你自己用 JavaScript 寫回呼函式,去解析異步請求回傳的資料再更新畫面;xajax 則讓你直接在 PHP 這一端控制內容。透過 xajaxresponse,你可以在 PHP 函數裡產生 XML 指令回傳給應用程式,xajax 的訊息泵會解析這些 XML,並依指令更新頁面的內容與狀態。
xajaxresponse 目前提供的指令包括:
單一 XML 回應可以包含多道指令,它們會依加入的順序被執行。舉個例子:使用者按下按鈕,onclick 觸發 JavaScript 端的包裝函數,該函數透過 XMLHttpRequest 送出異步請求,xajax 呼叫對應的 PHP 函數;PHP 函數完成資料庫查詢與資料處理後,用 xajaxresponse 產生含多道指令的 XML 回應,交給 xajax 訊息泵執行:
$objResponse = new xajaxresponse();
$objResponse->addAssign("myinput1","value",$dataFromDatabase);
$objResponse->addAssign("myinput1","style.color","red");
$objResponse->addAppend("mydiv1","innerHTML",$dataFromDatabase2);
$objResponse->addPrepend("mydiv2","innerHTML",$dataFromDatabase3);
$objResponse->addReplace("mydiv3","innerHTML","xajax","<strong>xajax</strong>");
$objResponse->addScript("var x = prompt(\"enter your name\");");
return $objResponse->getXML();
xajax 訊息泵解析這段 XML 後,會依序執行下列動作:
$dataFromDatabase 指派給 id 為 myinput1 的 value。$dataFromDatabase2 附加到 mydiv1 的 innerHTML 結尾。$dataFromDatabase3 插入到 mydiv2 的 innerHTML 開頭。而這一切,全部是在伺服器端的 PHP 函數裡,靠組裝並回傳一個 xajax XML 回應完成的。