PHP 8.4.2 Released!

    xml_parser_create_ns

    (PHP 4 >= 4.0.5, PHP 5, PHP 7, PHP 8)

    xml_parser_create_ns — Create an XML parser with namespace support

    Description

    xml_parser_create_ns(?string $encoding = null, string $separator = ":"): XMLParser

    xml_parser_create_ns() creates a new XML parser with XML namespace support and returns a XMLParser instance to be used by the other XML functions.

    Parameters

    encoding

    The input encoding is automatically detected, so that the encoding parameter specifies only the output encoding. The default output charset is UTF-8. The supported encodings are ISO-8859-1, UTF-8 and US-ASCII.

    separator

    With a namespace aware parser tag parameters passed to the various handler functions will consist of namespace and tag name separated by the string specified in separator.

    Return Values

    Returns a new XMLParser instance.

    Changelog

    Version Description
    8.0.0 This function returns an XMLParser instance now; previously, a resource was returned, or false on failure.
    8.0.0 encoding is nullable now.

    See Also

    Found A Problem?

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

    User Contributed Notes 2 notes

    up
    2
    jonnyNO at SPAM dot sanriowasteland dot net
    22 years ago
    This is from the Expat Function Reference by Clark Cooper, which is a reference to the C api.

    "XML_Parser XML_ParserCreateNS(const XML_Char*encoding, XML_Char sep)
    Constructs a new parser that has namespace processing in effect. Namespace expanded element names and attribute names are returned as a concatenation of the namespace URI, sep, and the local part of the name. This means that you should pick a character for sep that can't be part of a legal URI."

    (from http://www.xml.com/pub/a/1999/09/expat/reference.html)

    So thats what this function is for. Now you know.
    up
    0
    bishop at php dot net
    5 years ago
    Internals has proposed[1] changing this extension from resource-based to object-based. When this change is made, xml_parser_create_ns will return an object, not a resource. Application developers are encouraged to replace any checks for explicit success, like:

    <?php
    $res     = xml_parser_create_ns(/*...*/);
    if (!     is_resource($res)) {
    // ...
    }
    ?>

    With a check for explicit failure:
    <?php
    $res     = xml_parser_create_ns(/*...*/);
    if (    false === $res) {
    // ...
    }

    [    1]: https://marc.info/?l=php-internals&m=154998365013373&w=2
    ＋add a note
    To Top