一、概述及安裝

XML(可擴(kuò)展標(biāo)記語言，eXtensible Markup Language) 是一種在互聯(lián)網(wǎng)上用于結(jié)構(gòu)化文檔交互的數(shù)據(jù)格式。 它是互聯(lián)網(wǎng)協(xié)會(huì)(W3C)定義的一個(gè)標(biāo)準(zhǔn)。與 XML 及其相關(guān)技術(shù)的信息可訪問http://www.w3.org/XML/。

此 PHP 擴(kuò)展實(shí)現(xiàn) 支持 James Clark 使用 PHP 編寫的?expat。 此工具包可解析(但不能驗(yàn)證) XML 文檔。它支持 PHP 所提供的 3 種字符編碼：?US-ASCII,?ISO-8859-1?和?UTF-8。 不支持?UTF-16。

此擴(kuò)展可?創(chuàng)建 XML 解析器?并為不同的 XML 事件定義?處理程序(handler)。 每個(gè) XML 解析器還存在少數(shù)可以調(diào)節(jié)的參數(shù)。

此擴(kuò)展需要?libxml?PHP 擴(kuò)展。這表示需要使用?--enable-libxml?，盡管這將隱式完成因?yàn)?libxml 是缺省開啟的。

缺省情況下，此擴(kuò)展使用expat compat layer?。也可使用expat， 此庫位于?http://www.jclark.com/xml/expat.html。 使用expat庫中的 Makefile 是不會(huì)默認(rèn)構(gòu)建出庫文件的，可使用以下構(gòu)建規(guī)則進(jìn)行構(gòu)建：

libexpat.a: $(OBJS) ar -rc $@ $(OBJS) ranlib $@

expat 的源代碼 RPM 安裝包可在?http://sourceforge.net/projects/expat/?找到。

此擴(kuò)展默認(rèn)為啟用,編譯時(shí)可通過下列選項(xiàng)禁用：?--disable-xml

這些函數(shù)默認(rèn)為有效的，使用了捆綁的 expat 庫。您可以通過參數(shù)?--disable-xml?來屏蔽 XML 的支持。如果您將 PHP 編譯為 Apache 1.3.9 或更高版本的一個(gè)模塊， PHP 將自動(dòng)使用 Apache 捆綁的?expat?庫。如果您不希望使用該捆綁的 expat 庫，請?jiān)谶\(yùn)行 PHP 的 configure 配置腳本時(shí)使用參數(shù)?--with-expat-dir=DIR?，其中 DIR 應(yīng)該指向 expat 安裝的根目錄。

PHP 的 Windows 版本已內(nèi)建對此擴(kuò)展的支持。不需要載入額外的擴(kuò)展來使用這些函數(shù)。

二、事件處理器

XML 事件處理器的定義如下：

被支持的 XML 處理器PHP 處理器函數(shù)事件描述xml_set_element_handler()當(dāng) XML 解析器遇到開始或結(jié)束標(biāo)簽時(shí)，會(huì)觸發(fā)元素事件。 開始標(biāo)簽和結(jié)束標(biāo)簽有不同的處理器。xml_set_character_data_handler()字符數(shù)據(jù)范指 XML 文檔中所有非標(biāo)記的內(nèi)容，包括標(biāo)簽之間的空格。 注意，XML 解析器不會(huì)添加或刪除任何空格，由應(yīng)用程序(你)來判斷空格是否有意義。xml_set_processing_instruction_handler()PHP 程序員必須熟練掌握處理指令(PI)。<?php ?>是處理指令， 其中php被稱為“處理指令對象”。 除所有以“XML”開頭的處理指令對象是系統(tǒng)保留的外， 其他的處理函數(shù)均是由應(yīng)用程序指定的。xml_set_default_handler()不執(zhí)行其他處理函數(shù)，則會(huì)執(zhí)行缺省的處理函數(shù)。 在缺省的處理函數(shù)中可取得如 XML 和文檔類型聲明等信息。xml_set_unparsed_entity_decl_handler()未解析的實(shí)體聲明(NDATA)會(huì)調(diào)用此處理函數(shù)。xml_set_notation_decl_handler()符號(hào)聲明會(huì)調(diào)用此處理函數(shù)xml_set_external_entity_ref_handler()當(dāng) XML 解析器發(fā)現(xiàn)對外部已解析的普通實(shí)體的引用時(shí)， 會(huì)調(diào)用此處理函數(shù)。例如，引用一個(gè)文件或URL。實(shí)例可參見?XML 外部實(shí)體例程。三、大寫轉(zhuǎn)換

元素處理函數(shù)可取得元素名稱轉(zhuǎn)換為?case-folded(大寫字母)形式。 Case-folding 被定義為“將非大寫字母替換為相對應(yīng)的大寫字母的字符串操作”。換句話說，在 XML 中，case-folding 就是轉(zhuǎn)換為大寫。

默認(rèn)情況下，所有的通過處理函數(shù)的元素名都被轉(zhuǎn)換為大寫字母。每個(gè) XML 解析器可分別通過?xml_parser_get_option()與xml_parser_set_option()函數(shù)來查詢與控制此項(xiàng)功能。

四、錯(cuò)誤代碼

下列常量是 XML 相關(guān)的錯(cuò)誤代碼(?xml_parse()函數(shù)的返回值):

XML_ERROR_NONEXML_ERROR_NO_MEMORYXML_ERROR_SYNTAXXML_ERROR_NO_ELEMENTSXML_ERROR_INVALID_TOKENXML_ERROR_UNCLOSED_TOKENXML_ERROR_PARTIAL_CHARXML_ERROR_TAG_MISMATCHXML_ERROR_DUPLICATE_ATTRIBUTEXML_ERROR_JUNK_AFTER_DOC_ELEMENTXML_ERROR_PARAM_ENTITY_REFXML_ERROR_UNDEFINED_ENTITYXML_ERROR_RECURSIVE_ENTITY_REFXML_ERROR_ASYNC_ENTITYXML_ERROR_BAD_CHAR_REFXML_ERROR_BINARY_ENTITY_REFXML_ERROR_ATTRIBUTE_EXTERNAL_ENTITY_REFXML_ERROR_MISPLACED_XML_PIXML_ERROR_UNKNOWN_ENCODINGXML_ERROR_INCORRECT_ENCODINGXML_ERROR_UNCLOSED_CDATA_SECTIONXML_ERROR_EXTERNAL_ENTITY_HANDLING五、字符編碼

PHP 的 XML 擴(kuò)展通過幾種不同的字符編碼支持Unicode?字符集。 有兩類字符編碼，?原始編碼?和?目標(biāo)編碼. 在PHP的內(nèi)部展現(xiàn)中，文檔始終是使用UTF-8編碼。

當(dāng) XML 被?解析?后，原始編碼就完成了。 在創(chuàng)建 XML 解析器時(shí), 可以指定原始編碼(在XML 解析器此后的生命周期里，不能修改此編碼)。 被支持的原始編碼有?ISO-8859-1,?US-ASCII?和?UTF-8. 前兩種是單字節(jié)編碼, 即每一個(gè)字符表現(xiàn)為一個(gè)字節(jié)。?UTF-8?可將字符編碼為一串不定數(shù)量(最高21)的位(bit), 排列成1到4個(gè)字節(jié)。 PHP 中使用的默認(rèn)原始編碼是ISO-8859-1.

當(dāng) PHP 將數(shù)據(jù)傳給 XML 處理函數(shù)時(shí)，目標(biāo)編碼就完成了。 在創(chuàng)建 XML 處理器時(shí)，目標(biāo)編碼被設(shè)定為與原始編碼相同，但可任意修改。 目標(biāo)編碼會(huì)影響字符數(shù)據(jù)及標(biāo)簽名，與處理指令目標(biāo)。

如 XML 解析器遇到原始編碼所能表示的范圍之外的字符時(shí)，會(huì)返回一個(gè)錯(cuò)誤。

如 PHP 遇到在被解析的 XML 文檔中不能用所指定的目標(biāo)編碼表示的字符時(shí)， 這個(gè)問題字符會(huì)被“降級(jí)”。通常來說，就是那些字符會(huì)被替換成問號(hào)(?)。