Edit Report a Bug

    DOMXPath::registerNamespace

    (PHP 5, PHP 7, PHP 8)

    DOMXPath::registerNamespace — Registers the namespace with the DOMXPath object

    Description

    public DOMXPath::registerNamespace(string $prefix, string $namespace): bool

    Registers the namespace and prefix with the DOMXPath object.

    Parameters

    prefix

    The prefix.

    namespace

    The URI of the namespace.

    Return Values

    Returns true on success or false on failure.

    add a note add a note

    User Contributed Notes 6 notes

    up
    24
    spam at spam dot spam
    19 years ago
    It is mentioned in a few places on the web, but it wasn't mentioned here. You need to use this function to set up a prefix for the default namespace of a document.

    For instance, if you are trying to parse a Microsoft Spreadsheet XML file, which has the default namespace of "urn:schemas-microsoft-com:office:spreadsheet":

    $doc = DOMDocument::load("my_spreadsheet.xml);
    $xpath = new DOMXPath($doc);
    $xpath->registerNamespace("m",
            "urn:schemas-microsoft-com:office:spreadsheet");
    $query = '/m:Workbook/m:Worksheet[1]/m:Table';
    $result = $xpath->query($query, $doc);

    You can use anything in place of the 'm', but you have to specify something! Just asking for "/Workbook/Worksheet/Table" doesn't work.
    up
    9
    cameron kellough
    17 years ago
    This is called prefix mapping and it is necessary to use xpath to handle documents which have default namespaces. //root/item will search for items with no namespace, not items with the namespace described as the default in the xmlns declaration.  This problem is maddening as it just looks on the surface like xpath isn't working.
    up
    8
    dulao5 at gmail dot com
    15 years ago
    The following code can work for XML default namespace.
    <?php
    $xml     = <<<EOT
    <?xml version="1.0" encoding="UTF-8"?>
    <entry xmlns="http://www.w3.org/2005/Atom" xmlns:other="http://other.w3.org/other" >
            <id>uYG7-sPwjFg</id>
            <published>2009-05-17T18:29:31.000Z</published>
    </entry>
    EOT;

    $doc = new DOMDocument;
    $doc->loadXML($xml);
    $xpath =  DOMXPath($doc);

    $xpath->registerNamespace('atom', "http://www.w3.org/2005/Atom");

    $xpath_str = '//atom:entry/atom:published/text()';

    $entries = $xpath->evaluate($xpath_str);

    print     $entries->item(0)->nodeValue ."\n";

    ?>
    up
    4
    igor dot pellegrini at diespam-berlinonline dot de
    9 years ago
    The documentation is not really detailed.
    Probably someone is also interested in the possibility of unregistering the namespace.

    Worths to note that the original libxml function "xmlXPathRegisterNs()"

    * Does NOT accept NULL or empty string for the argument "$prefix".

       and

    * Unregisters the namespace if the "$namespaceURI" argument is NULL.

    Here the documentation:
    http://xmlsoft.org/html/libxml-xpathInternals.html#xmlXPathRegisterNs
    up
    2
    xmedeko at gmail dot com
    13 years ago
    A general way to register the root default namespace:

    <?php
    $xml     = new DomDocument();
    $xml->load('data.xml');
    $xpath = new DOMXPath($xml);
    $rootNamespace = $xml->lookupNamespaceUri($xml->namespaceURI);
    $xpath->registerNamespace('x', $rootNamespace);
    ?>

    And then just query:

    <?php $elementList = $xpath->query('//x:items/x:name'); ?>
    up
    -3
    agent009
    15 years ago
    Ok, here's a function that extends XPath syntax with the following special characters:

    ~ inserts default namespace prefix if defined

    # shorthand for text()

    % shorthand for comment()

    $ shorthand for node()

    ?* shorthand for processing-instruction()

    ?foo shorthand for processing-instruction("foo")

    ? shorthand for processing-instruction("")

    ^ escapes following character (with literal or SGML entity as needed)

    All of the above except ^ are ignored within quoted strings

    <?php
    function extendXPath($str, $defns = NULL) {
           $quote = false;
           $map = array(
              '~' => isset($defns) ? "$defns:" : '',
              '#' => 'text()',
              '%' => 'comment()',
              '$' => 'node()'
           );
           $out = '';
      
       for (    $i = 0, $len = strlen($str); $i < $len; $i++) {
              $c = $str[$i];
          if (!    $quote && array_key_exists($c, $map)) {
                 $out .= $map[$c];
          } else switch (    $c) {
             case     '^':
                    $out .= htmlspecialchars($str[++$i], ENT_QUOTES);
                break;
             case     '?':
                if (    $quote) {
                       $out .= $c;
                } elseif (    $str[$i + 1] == '*') {
                       $out .= 'processing-instruction()';
                       $i++;
                } else {
                       preg_match('/^\w+/', substr($str, $i + 1), $matches);
                       $out .= 'processing-instruction("'.$matches[0].'")';
                       $i += strlen($matches[0]);
                };
                break;
             case     '"':
                    $quote = !$quote;
             default:
                    $out .= $c;
          };
       };
      
       return     $out;
    }
    ?>
    add a note add a note
    To Top