PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    xml_set_default_handler

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

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

    説明

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

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

    パラメータ

    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 のシグネチャは、以下でなければいけません:

    handler(XMLParser $parser, string $data): void
    parser
    ハンドラをコールするXMLパーサ
    data
    data には、文字データを文字列として指定します。 これは、XML 宣言またはドキュメント型宣言、エンティティ、 他にハンドラがない別のデータとすることが可能です。

    戻り値

    常に true を返します。

    変更履歴

    バージョン 説明
    8.4.0 非 callable な string を handler に渡すことは、現在非推奨となっています。 メソッドには適切な callable を使用するか、ハンドラをリセットする場合は null を使用してください。
    8.4.0 handler が callable として有効であるかどうかは、 呼び出し時ではなく、ハンドラーを設定する際にチェックされるようになりました。
    8.0.0 引数 parser は、 XMLParser インスタンスを期待するようになりました。 これより前のバージョンでは、有効な xml resource が期待されていました。

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 3 notes

    up
    0
    jp dot amarok at email dot cz
    8 months ago
    For anyone who was also wondering what kind of events this function actually handles:

    it's used in cases when an XML comment is found or an additional declaration like an xml-stylesheet. In such cases the data argument contains the whole string as it is, for example:

    <!-- this is a comment -->
    <?xml-stylesheet title="mystyle" type="text/xsl" href="style.xsl" ?>
    up
    -2
    phillip
    19 years ago
    it seems to me that in PHP5 the function defined as default-handler (using xml_set_default_handler()) doesen't get passed the cdata anymore:

    i.e.:
    xml_set_element_handler($this->parser, 'parseSTART', 'parseEND');
    xml_set_default_handler($this->parser, 'parseDEFAULT');
    function parseSTART() { ... }
    function parseEND() { ... }
    function parseDEFAULT() { ... }

    under PHP5, parseDEFAULT will NOT get passed any cdata, but unter PHP4 it will. at least that's my take on the strange stuff (not) happening after migrating to PHP5.

    my solution was to add a xml_set_character_data_handler($parser, 'parseDEFAULT'). it worked for me.
    up
    -3
    anoril at anoril dot com
    18 years ago
    I have the same issue using two installation of PHP5: on accepts to use the default handler while the other only uses the character_data one.

    Maybe a configuration problem...

    ;) Nonor.
    ＋add a note
    To Top