XML パーサ parser
の処理されないエンティティ
宣言用ハンドラ関数を設定します。handler
は、
parser
に関して xml_parse()
がコールされた際に必要な関数の名前を有する文字列です。
このハンドラは、XML パーサが次のような NDATA 宣言を有する外部エンティティ 宣言を処理する際にコールされます。
<!ENTITY <parameter>name</parameter> {<parameter>publicId</parameter> | <parameter>systemId</parameter>} NDATA <parameter>notationName</parameter> |
外部エンティティ宣言の記述用定義に関しては、 XML 1.0 仕様の 4.2.2 節を参照ください。
handler
という名前の関数は次のような
6 つのパラメータをとる必要があります。
handler ( resource parser, string entity_name, string base, string system_id, string public_id, string notation_name )
parser
最初のパラメータ、parser は ハンドラをコールする XML パーサへのリファレンスです。
entity_name
宣言しようとするエンティティの名前。
base
外部エンティティのシステム ID(systemId
)
を取得する際の基本となります。現在、このパラメータは、常に
空の文字列に設定されています。
system_id
外部エンティティのシステム ID。
public_id
外部エンティティのパブリック ID。
notation_name
このエンティティの表記法の名前 (xml_set_notation_decl_handler() を参照ください)。
あるハンドラ関数が空の文字列または FALSE に設定 されていた場合、そのハンドラは無効となります。
ハンドラが設定されている場合に TRUE、parser
がパーサでない場合に FALSE を返します。
注意: 関数名の代わりに、オブジェクトへの リファレンスを格納した配列とメソッド名を指定することもできます。