xml_set_processing_instruction_handler

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

xml_set_processing_instruction_handler 建立處理指令(PI)處理器

說(shuō)明

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

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

處理指令有如下格式:

<?
target data
?>
      
您可以將 PHP 代碼放置在類似的標(biāo)識(shí)符中,但要注意一個(gè)限制:在 XML 處理指令(PI)中,PI 的終止符(?>)不能被引號(hào)引用,因此該字符序列不應(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ù)時(shí)已存在。

handler 參數(shù)命名的函數(shù)名必須接受三個(gè)參數(shù):

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

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

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

返回值

成功時(shí)返回 true, 或者在失敗時(shí)返回 false。