Add XPath-class

Author: tvdijen

src/Constants.php

@@ -18,6 +18,12 @@ class Constants extends \SimpleSAML\XML\Constants
     public const string NS_SEC_EXT =
         'http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd';
 
+    /**
+     * The namespace for WS-Security extensions 1.1.
+     */
+    public const string NS_SEC_EXT_11 =
+        'http://docs.oasis-open.org/wss/oasis-wss-wssecurity-secext-1.1.xsd';
+
     /**
      * The namespace for WS-Security utilities protocol.
      */

src/Utils/XPath.php

@@ -0,0 +1,37 @@
+<?php
+
+declare(strict_types=1);
+
+namespace SimpleSAML\WebServices\Security\Utils;
+
+use DOMNode;
+use DOMXPath;
+use SimpleSAML\WebServices\Security\Constants as C;
+
+/**
+ * Compilation of utilities for XPath.
+ *
+ * @package simplesamlphp/xml-wss-core
+ */
+class XPath extends \SimpleSAML\XPath\XPath
+{
+    /*
+     * Get a DOMXPath object that can be used to search for WS Security elements.
+     *
+     * @param \DOMNode $node The document to associate to the DOMXPath object.
+     * @param bool $autoregister Whether to auto-register all namespaces used in the document
+     *
+     * @return \DOMXPath A DOMXPath object ready to use in the given document, with several
+     *   ws-related namespaces already registered.
+     */
+    public static function getXPath(DOMNode $node, bool $autoregister = false): DOMXPath
+    {
+        $xp = parent::getXPath($node, $autoregister);
+
+        $xp->registerNamespace('wsse', C::NS_SEC_EXT);
+        $xp->registerNamespace('wsse11', C::NS_SEC_EXT_11);
+        $xp->registerNamespace('wsu', C::NS_SEC_UTIL);
+
+        return $xp;
+    }
+}