xml_set_end_namespace_decl_handler
(PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)
xml_set_end_namespace_decl_handler — 名前空間終了ハンドラを設定する
説明
名前空間宣言のスコープを抜けるときにコールされるハンドラを設定します。 これがコールされるのは、各名前空間宣言において、 名前空間が宣言された要素の終了タグのハンドラがコールされた後のことです。
このイベントは libXML ではサポートされていません。 そのため、登録されたハンドラは呼ばれません。
パラメータ
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
のシグネチャは、以下でなければいけません:parser
- ハンドラをコールするXMLパーサ
prefix
-
XML オブジェクト内の名前空間を参照する際に使う文字列。
prefix が存在しない場合は、
false
になります。
戻り値
常に true
を返します。