xml_set_unparsed_entity_decl_handler

PHP関数リファレンス

xml_set_unparsed_entity_decl_handler

(PHP 4, PHP 5)
xml_set_unparsed_entity_decl_handler — 処理されないエンティティ宣言用ハンドラを設定する

説明

bool xml_set_unparsed_entity_decl_handler ( resource parser, callback handler )
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 を返します。
注意: 関数名の代わりに、オブジェクトへの リファレンスを格納した配列とメソッド名を指定することもできます。