xml_set_notation_decl_handler

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

xml_set_notation_decl_handler建立注釋聲明處理器

說(shuō)明

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

parser 參數(shù)指定的 XML 解析器建立注釋聲明處理器函數(shù)。

注釋聲明是文檔 DTD 的一部分,并有如下格式:

<!NOTATION <parameter>name</parameter>
{<parameter>system_id</parameter> | <parameter>public_id</parameter>}?>
。請(qǐng)參考 ? XML 1.0 參考的第 4.7 節(jié)以了解注釋聲明的定義。

參數(shù)

parser

XML 解析器的引用,用于設(shè)置聲明處理器函數(shù)。

handler

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

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

handler(
    resource $parser,
    string $notation_name,
    string $base,
    string $system_id,
    string $public_id
)
parser
第一個(gè)參數(shù) parser 為指向要調(diào)用處理器的 XML 解析器的指針。
notation_name
該參數(shù)為以上注釋格式定義中的 name 參數(shù)。
base
這個(gè)參數(shù)是解析注釋聲明的系統(tǒng)標(biāo)識(shí)符(system_id)的基礎(chǔ)。當(dāng)前該參數(shù)通常都被設(shè)置為空字符串。
system_id
外部注釋聲明的系統(tǒng)標(biāo)識(shí)符。
public_id
外部注釋聲明的公共標(biāo)識(shí)符。

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

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

返回值

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