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 は ハンドラをコールする XML パーサへのリファレンスです。
宣言しようとするエンティティの名前。
外部エンティティのシステム ID(systemId) を取得する際の基本となります。現在、このパラメータは、常に 空の文字列に設定されています。
外部エンティティのシステム ID。
外部エンティティのパブリック ID。
このエンティティの表記法の名前 (xml_set_notation_decl_handler() を参照ください)。
あるハンドラ関数が空の文字列または FALSE に設定 されていた場合、そのハンドラは無効となります。
ハンドラが設定されている場合に TRUE、parser がパーサでない場合に FALSE を返します。
注意: 関数名の代わりに、オブジェクトへの リファレンスを格納した配列とメソッド名を指定することもできます。