xml_set_processing_instruction_handler

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_set_processing_instruction_handler — 建立處理指令（PI）處理器

說明

xml_set_processing_instruction_handler(resource $parser, callable $handler): bool

為 parser 參數(shù)指定的 XML 解析器建立處理指令（PI）處理器函數(shù)。

處理指令有如下格式： 

<?
target data
?>
您可以將 PHP 代碼放置在類似的標(biāo)識符中，但要注意一個限制：在 XML 處理指令（PI）中，PI 的終止符（?>）不能被引號引用，因此該字符序列不應(yīng)該在您用 PI 嵌入到 XML 文檔中的 PHP 代碼中出現(xiàn)。否則，剩下的 PHP 代碼，包括“真正”的 PI 終止符將被當(dāng)作字符數(shù)據(jù)處理。

參數(shù)

parser

XML 解析器的引用，用于建立處理指令（PI）處理器。

handler

參數(shù) handler 為表示函數(shù)名稱的字符串，函數(shù)必須在為 parser 指定的解析器調(diào)用 xml_parse() 函數(shù)時已存在。

由 handler 參數(shù)命名的函數(shù)名必須接受三個參數(shù)：

handler(resource $parser, string $target, string $data)
parser
第一個參數(shù) parser 為指向要調(diào)用處理器的 XML 解析器的指針。
target
第二個參數(shù) target 為 PI 對象（PI target）。
data
第三個參數(shù) data 包含了 PI 數(shù)據(jù)。

如果處理器函數(shù)名被設(shè)置為空字符串或者 false，則該有問題的處理器將被屏蔽。

注意: 除了函數(shù)名，含有對象引用的數(shù)組和方法名也可以作為參數(shù)。

返回值

成功時返回 true， 或者在失敗時返回 false。