Migrate DOM-classes to PHP 8.4's new DOM-API

Author: tvdijen

src/XML/AbstractElement.php

@@ -4,7 +4,7 @@
 
 namespace SimpleSAML\XML;
 
-use DOMElement;
+use Dom;
 use RuntimeException;
 use SimpleSAML\XML\Assert\Assert;
 use SimpleSAML\XML\SerializableElementTrait;
@@ -35,9 +35,9 @@ abstract class AbstractElement implements
     /**
      * Create a document structure for this element
      *
-     * @param \DOMElement|null $parent The element we should append to.
+     * @param \Dom\Element|null $parent The element we should append to.
      */
-    public function instantiateParentElement(?DOMElement $parent = null): DOMElement
+    public function instantiateParentElement(?Dom\Element $parent = null): Dom\Element
     {
         $qualifiedName = $this->getQualifiedName();
         $namespace = static::getNamespaceURI();
@@ -59,15 +59,15 @@ public function instantiateParentElement(?DOMElement $parent = null): DOMElement
 
     /**
      * @template T of \SimpleSAML\XMLSchema\Type\Interface\ValueTypeInterface
-     * @param \DOMElement     $xml The element where we should search for the attribute.
+     * @param \Dom\Element    $xml The element where we should search for the attribute.
      * @param string          $name The name of the attribute.
      * @param class-string<T> $type The type of the attribute value.
      * @return T
      *
      * @throws \SimpleSAML\XMLSchema\Exception\MissingAttributeException if the attribute is missing from the element
      */
     public static function getAttribute(
-        DOMElement $xml,
+        Dom\Element $xml,
         string $name,
         string $type = StringValue::class,
     ): ValueTypeInterface {
@@ -91,15 +91,15 @@ public static function getAttribute(
      * Get the value of an attribute from a given element.
      *
      * @template T of \SimpleSAML\XMLSchema\Type\Interface\ValueTypeInterface
-     * @param \DOMElement  $xml The element where we should search for the attribute.
+     * @param \Dom\Element  $xml The element where we should search for the attribute.
      * @param string       $name The name of the attribute.
      * @param class-string<T> $type The type of the attribute value.
      * @param \SimpleSAML\XMLSchema\Type\Interface\ValueTypeInterface|null $default
      *   The default to return in case the attribute does not exist and it is optional.
      * @return ($default is \SimpleSAML\XMLSchema\Type\Interface\ValueTypeInterface ? T : T|null)
      */
     public static function getOptionalAttribute(
-        DOMElement $xml,
+        Dom\Element $xml,
         string $name,
         string $type = StringValue::class,
         ?ValueTypeInterface $default = null,
@@ -142,15 +142,15 @@ public function getQualifiedName(): string
     /**
      * Extract localized names from the children of a given element.
      *
-     * @param \DOMElement $parent The element we want to search.
+     * @param \Dom\Element $parent The element we want to search.
      * @return list<static> An array of objects of this class.
      */
-    public static function getChildrenOfClass(DOMElement $parent): array
+    public static function getChildrenOfClass(Dom\Element $parent): array
     {
         $ret = [];
         foreach ($parent->childNodes as $node) {
             if (
-                $node instanceof DOMElement
+                $node instanceof Dom\Element
                 && $node->namespaceURI === static::getNamespaceURI()
                 && $node->localName === static::getLocalName()
             ) {

src/XML/Attribute.php

@@ -4,8 +4,7 @@
 
 namespace SimpleSAML\XML;
 
-use DOMAttr;
-use DOMElement;
+use Dom;
 use SimpleSAML\XML\Assert\Assert;
 use SimpleSAML\XMLSchema\Type\Interface\ValueTypeInterface;
 use SimpleSAML\XMLSchema\Type\StringValue;
@@ -83,9 +82,9 @@ public function getAttrValue(): ValueTypeInterface
     /**
      * Create a class from XML
      *
-     * @param \DOMAttr $attr
+     * @param \Dom\Attr $attr
      */
-    public static function fromXML(DOMAttr $attr): static
+    public static function fromXML(Dom\Attr $attr): static
     {
         return new static($attr->namespaceURI, $attr->prefix, $attr->localName, StringValue::fromString($attr->value));
     }
@@ -94,9 +93,9 @@ public static function fromXML(DOMAttr $attr): static
     /**
      * Create XML from this class
      *
-     * @param \DOMElement $parent
+     * @param \Dom\Element $parent
      */
-    public function toXML(DOMElement $parent): DOMElement
+    public function toXML(Dom\Element $parent): Dom\Element
     {
         if ($this->getNamespaceURI() !== null && !$parent->lookupPrefix($this->getNamespacePrefix())) {
             $parent->setAttributeNS(

src/XML/Chunk.php

@@ -4,7 +4,7 @@
 
 namespace SimpleSAML\XML;
 
-use DOMElement;
+use Dom;
 use SimpleSAML\XML\Assert\Assert;
 use SimpleSAML\XML\DOMDocumentFactory;
 use SimpleSAML\XML\SerializableElementTrait;
@@ -57,10 +57,10 @@ final class Chunk implements
     /**
      * Create an XML Chunk from a copy of the given \DOMElement.
      *
-     * @param \DOMElement $xml The element we should copy.
+     * @param \Dom\Element $xml The element we should copy.
      */
     public function __construct(
-        protected DOMElement $xml,
+        protected Dom\Element $xml,
     ) {
         $this->setLocalName($xml->localName);
         $this->setNamespaceURI($xml->namespaceURI);
@@ -132,9 +132,9 @@ protected function setNamespaceURI(?string $namespaceURI = null): void
 
 
     /**
-     * Get this \DOMElement.
+     * Get this \Dom\Element.
      */
-    public function getXML(): DOMElement
+    public function getXML(): Dom\Element
     {
         return $this->xml;
     }
@@ -180,15 +180,15 @@ public function getQualifiedName(): string
      * Get the value of an attribute from a given element.
      *
      * @template T of \SimpleSAML\XMLSchema\Type\Interface\ValueTypeInterface
-     * @param \DOMElement     $xml The element where we should search for the attribute.
+     * @param \Dom\Element     $xml The element where we should search for the attribute.
      * @param string          $name The name of the attribute.
      * @param class-string<T> $type The type of the attribute value.
      * @return T
      *
      * @throws \SimpleSAML\XMLSchema\Exception\MissingAttributeException if the attribute is missing from the element
      */
     public static function getAttribute(
-        DOMElement $xml,
+        Dom\Element $xml,
         string $name,
         string $type = StringValue::class,
     ): ValueTypeInterface {
@@ -209,15 +209,15 @@ public static function getAttribute(
      * Get the value of an attribute from a given element.
      *
      * @template T of \SimpleSAML\XMLSchema\Type\Interface\ValueTypeInterface
-     * @param \DOMElement  $xml The element where we should search for the attribute.
+     * @param \Dom\Element  $xml The element where we should search for the attribute.
      * @param string       $name The name of the attribute.
      * @param class-string<T> $type The type of the attribute value.
      * @param \SimpleSAML\XMLSchema\Type\Interface\ValueTypeInterface|null $default
      *   The default to return in case the attribute does not exist and it is optional.
      * @return ($default is \SimpleSAML\XMLSchema\Type\Interface\ValueTypeInterface ? T : T|null)
      */
     public static function getOptionalAttribute(
-        DOMElement $xml,
+        Dom\Element $xml,
         string $name,
         string $type = StringValue::class,
         ?ValueTypeInterface $default = null,
@@ -235,16 +235,16 @@ public static function getOptionalAttribute(
      */
     public function isEmptyElement(): bool
     {
-        /** @var \DOMElement $xml */
+        /** @var \Dom\Element $xml */
         $xml = $this->getXML();
         return ($xml->childNodes->length === 0) && ($xml->attributes->count() === 0);
     }
 
 
     /**
-     * @param \DOMElement $xml
+     * @param \Dom\Element $xml
      */
-    public static function fromXML(DOMElement $xml): static
+    public static function fromXML(Dom\Element $xml): static
     {
         return new static($xml);
     }
@@ -253,10 +253,10 @@ public static function fromXML(DOMElement $xml): static
     /**
      * Append this XML element to a different XML element.
      *
-     * @param  \DOMElement|null $parent The element we should append this element to.
-     * @return \DOMElement The new element.
+     * @param  \Dom\Element|null $parent The element we should append this element to.
+     * @return \Dom\Element The new element.
      */
-    public function toXML(?DOMElement $parent = null): DOMElement
+    public function toXML(?Dom\Element $parent = null): Dom\Element
     {
         if ($parent === null) {
             $doc = DOMDocumentFactory::create();

src/XML/Container/XMLSchemaElementsTrait.php

@@ -4,7 +4,7 @@
 
 namespace SimpleSAML\XML\Container;
 
-use DOMText;
+use Dom;
 use SimpleSAML\XML\DOMDocumentFactory;
 use SimpleSAML\XMLSchema\Type\AnyURIValue;
 use SimpleSAML\XMLSchema\XML\Appinfo;
@@ -26,22 +26,41 @@ trait XMLSchemaElementsTrait
     /** @var array<positive-int, \SimpleSAML\XMLSchema\XML\Appinfo> */
     protected array $appinfo = [];
 
+    /** @var array<non-empty-string, \Dom\Text> */
+    protected array $domText = [];
+
 
     /** @param positive-int $x */
     public function getAppinfo(int $x = 1): Appinfo
     {
         if (!array_key_exists($x, $this->appinfo)) {
-            $appinfoDocument = DOMDocumentFactory::create();
-            $text = new DOMText(sprintf('Application Information (%d)', $x));
-            $appinfoDocument->appendChild($text);
+            $domTextNode = $this->getDOMText(sprintf('Application Information (%d)', $x));
 
             $this->appinfo[$x] = new Appinfo(
-                $appinfoDocument->childNodes,
+                $domTextNode,
                 AnyURIValue::fromString(static::SOURCE),
                 [$this->getXMLAttribute($x)],
             );
         }
 
         return $this->appinfo[$x];
     }
+
+
+    /** @param non-empty-string $text */
+    public function getDOMText(string $text): Dom\NodeList
+    {
+        if (!array_key_exists($text, $this->domText)) {
+            $doc = DOMDocumentFactory::create();
+
+            $elt = $doc->createElement('root');
+            $domText = $doc->createTextNode($text);
+
+            $elt->appendChild($domText);
+
+            $this->domText[$text] = $elt->childNodes;
+        }
+
+        return $this->domText[$text];
+    }
 }