xml_set_unparsed_entity_decl_handler

パラメータ

parser

XMLパーサ

handler

null が渡されると、ハンドラはデフォルトの状態にリセットされます。

警告

空文字列を渡すことでもハンドラはリセットされますが、これは PHP 8.4.0 以降非推奨となっています。

handler が callable の場合、その callable がハンドラとして設定されます。

handler が文字列の場合、xml_set_object で設定されたオブジェクトのメソッド名になります。

警告

PHP 8.4.0 以降、非推奨となっています。

警告

PHP 8.4.0 以降では、実際に呼び出されるときではなく、ハンドラを設定する際に callable であるかがチェックされます。 従って、コールバックとしてメソッド文字列を指定する場合、それより前に、 xml_set_object を呼び出しておく必要があります。 しかし、この動作も PHP 8.4.0 以降非推奨となっているため、メソッドには適切な callable を使用することが推奨されます。

handler のシグネチャは、以下でなければいけません:

void handler(
    XMLParser $parser,
    string $entity_name,
    stringfalse $base,
    string $system_id,
    stringfalse $public_id,
    stringfalse $notation_name
)

parser

ハンドラをコールするXMLパーサ

entity_name

定義しようとするエンティティの名前。

base

外部エンティティのシステム ID(systemId) を取得する際のベースになります。

system_id

外部エンティティのシステム ID。

public_id

外部エンティティのパブリック ID。

notation_name

このエンティティの表記法の名前 (xml_set_notation_decl_handler を参照ください)。