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
17
spam at spam dot spam
18 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
7
cameron kellough
16 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
5
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
8
dulao5 at gmail dot com
14 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
2
xmedeko at gmail dot com
12 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
14 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;
}
?>
To Top