xml_set_default_handler

(PHP 4, PHP 5, PHP 7, PHP 8)

xml_set_default_handler — デフォルトのハンドラを設定する

xml_set_default_handler(XMLParser $parser, callable $handler): bool

XMLパーサ parser のデフォルトのハンドラ関数を設定します。

parser

デフォルトのハンドラ関数を設定する XML パーサへの参照。

handler

handler は、 parser に関して xml_parse() がコールされた際に必要な関数の名前を有する文字列です。

handler という名前の関数は、次の 2 つのパラメータをとる必要があります。

handler(XMLParser $parser, string $data)

parser: 最初のパラメータである parser は、ハンドラをコールした XML パーサへのリファレンスです。
data: 2 番目のパラメータである data は、文字データを有しています。これは、XML 宣言またはドキュメント型宣言、エンティティ、他にハンドラがない別のデータとすることが可能です。

ハンドラ関数が空の文字列または、false に設定されている場合、そのハンドラは無効です。

注意: 関数名の代わりに、オブジェクトへのリファレンスを格納した配列とメソッド名を指定することもできます。

成功した場合に true を、失敗した場合に false を返します。

バージョン	説明
8.0.0	引数 `parser` は、 XMLParser インスタンスを期待するようになりました。これより前のバージョンでは、リソースが期待されていました。