PHP 最大的賣點是免費,而 MySQL 為需要資料庫功能的開發者提供了同樣免費的方案。兩者的共同缺點是設定與管理略嫌繁瑣。本文示範如何寫一個類別,把 MySQL 連線與 XML 輸出打包起來,讓你在任何 PHP 腳本中都能直接取用。
本文使用的版本是 PHP 4.3.4 for Win32 與 MySQL 4.0.16 for Win32。MySQL 安裝單純,照指示走即可;PHP 稍微複雜一些。
PHP 下載頁有兩個檔案:ZIP 檔與安裝檔。因為我們需要 ZIP 檔中的擴充,所以兩個都要抓。下載後的步驟如下:
iconv.dll,放進 Windows 的系統資料夾。extensions 的目錄。php_domxml.dll 解壓到該目錄。extension_dir = 的值改成第 3 步設定的完整路徑。;extension=php_domxml.dll 這一行,刪掉行首的分號。在 Web 根目錄下建立 test.php(以下程式碼在 IIS 5.0 + Windows 2000 SP3 上測試可正常執行):
<?php
$myxml = new CMySQLXML("localhost", "test_user", "password", "test");
echo $myxml->run_sql_return_XML("SELECT * FROM users");
class CMySQLXML {
var $host;
var $user;
var $password;
var $db;
function CMySQLXML($host, $user, $password, $db) {
$this->host = $host;
$this->user = $user;
$this->password = $password;
$this->db = $db;
}
function run_sql_return_XML($sql_string) {
$connection = mysql_connect($this->host, $this->user, $this->password);
mysql_select_db($this->db);
$result = mysql_query($sql_string);
$doc = domxml_open_mem("<root/>");
$doc_root = $doc->document_element();
while ($row = mysql_fetch_array($result, MYSQL_ASSOC)) {
$num_fields = mysql_num_fields($result);
// 以資料表名稱作為列元素
$row_element = $doc->create_element(
mysql_field_table($result, 0)
);
$row_element = $doc_root->append_child($row_element);
// 每個欄位產生一個子元素
for ($i = 0; $i < $num_fields; $i++) {
$field_name = mysql_field_name($result, $i);
$col_element = $doc->create_element($field_name);
$col_element = $row_element->append_child($col_element);
$text_node = $doc->create_text_node($row[$field_name]);
$col_element->append_child($text_node);
}
}
mysql_free_result($result);
mysql_close($connection);
return $doc->dump_mem(false);
}
}
?>
執行前請先準備好 MySQL 中的 test 資料庫、其中的 users 表,以及一個可讀取該庫的使用者帳號。建立資料庫與資料表的細節可參考 MySQL 官方文件。
CMySQLXML 的建構子接四個參數:主機名稱、使用者名稱、密碼、資料庫名稱,分別對應類別的四個成員變數。
類別只提供一個方法 run_sql_return_XML(),接受一段 SQL 查詢字串。執行流程是:
$result;domxml_open_mem() 建立一個 DOMDocument 物件,起點是 <root/>;回傳時 dump_mem(false) 的參數控制是否附上 XML 宣告;設為 false 表示不要,若你需要完整文件,改成 true 即可。
這套 domxml 擴充除了函式命名慣例之外,大致遵循 W3C 的 DOM 規範。若需要更詳細的 DOM 資訊可查 W3C 站點,domxml 的文件則可從 PHP 官方取得。
必須坦白說清楚的是:這份程式碼有明確的時代限制。domxml 擴充在 PHP 5 之後已被 newtDOM... 更正說法:已被內建的 DOM 擴充取代而不再維護;mysql_* 系列函式也在 PHP 7 中遭到移除。若要在現代環境實作同樣的功能,應該改用 PDO 或 mysqli 搭配 DOMDocument:
<?php
$pdo = new PDO('mysql:host=localhost;dbname=test', 'test_user', 'password');
$stmt = $pdo->query('SELECT * FROM users');
$doc = new DOMDocument('1.0', 'UTF-8');
$root = $doc->createElement('root');
$doc->appendChild($root);
foreach ($stmt->fetchAll(PDO::FETCH_ASSOC) as $row) {
$rowEl = $doc->createElement('user');
foreach ($row as $name => $value) {
$colEl = $doc->createElement($name);
$colEl->appendChild($doc->createTextNode($value));
$rowEl->appendChild($colEl);
}
$root->appendChild($rowEl);
}
header('Content-Type: application/xml; charset=utf-8');
echo $doc->saveXML();
這個版本除了用 PDO 取代舊的 mysql 擴充,還多做了一件重要的事:欄位值一律經由 createTextNode 寫入,由 DOM 負責轉義,避免文字中的 &、< 破壞文件結構。此外,使用 PDO 預處理語句也能避免 SQL injection 風險——這在把外部參數送進查詢時是必須的。