xml_set_processing_instruction

說明

bool xml_set_processing_instruction_handler ( resource parser, callback handler )

為 parser 參數特殊的 XML 解析器建立處理指令（PI）處理器函數。參數 start_element_handler 和 end_element_handler 為表示函數名稱的字串，這些函數必須在為 parser 特殊的解析器呼叫 xml_parse() 函數時已存在。

處理指令有如下格式：

<?target
       data?>

您可以將 PHP 代碼放置在類似的標識符中，但要注意一個限制：在 XML 處理指令（PI）中，PI 的終止符（?>）不能被引號引用，因此該字元序列不應該在您用 PI 內嵌到 XML 文件中的 PHP 代碼中出現。否則，剩下的 PHP 代碼，內含「真正」的 PI 終止符將被當作字元資料處理。

由 handler 參數命名的函數名必須接受三個參數： handler ( resource parser, string target, string data )

parser: 第一個參數 parser 為指向要呼叫處理器的 XML 解析器的指標。
target: 第二個參數 target 為 PI 物件（PI target）。
data: 第二個參數 target 為 PI 資料（PI data）。

若果處理器函數名被設定為空字串或是 FALSE，則該有問題的處理器將被屏蔽。

若果處理器被成功的建立，該函數將返回 TRUE；若果 parser 指向的不是合法的解析器，函數該函數將返回 FALSE。

注: 除了函數名，還可以用一個陣列作參數，該陣列由一個物件名和該對象的一個方法名兩個元素組成。