Moved XmlBuilder from codeception/codeception

Author: Naktibalda

src/Codeception/Util/Soap.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Codeception\Util;
+
+/**
+ * This class is left for BC compatibility.
+ * Most of its contents moved to parent
+ *
+ * Class Soap
+ * @package Codeception\Util
+ */
+class Soap extends Xml
+{
+    public static function request(): XmlBuilder
+    {
+        return new XmlBuilder();
+    }
+
+    public static function response(): XmlBuilder
+    {
+        return new XmlBuilder();
+    }
+}

src/Codeception/Util/Xml.php

@@ -0,0 +1,55 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Codeception\Util;
+
+use DOMDocument;
+use DOMElement;
+use DOMNode;
+use function is_array;
+
+class Xml
+{
+    public static function arrayToXml(DOMDocument $xml, DOMNode $domNode, array $array = []): DOMDocument
+    {
+        foreach ($array as $el => $val) {
+            if (is_array($val)) {
+                self::arrayToXml($xml, $domNode->$el, $val);
+            } else {
+                $domNode->appendChild($xml->createElement($el, $val));
+            }
+        }
+        return $xml;
+    }
+
+    public static function toXml(DOMDocument|DOMElement|XmlBuilder|string|null $xml): DOMDocument
+    {
+        if ($xml instanceof XmlBuilder) {
+            return $xml->getDom();
+        }
+        if ($xml instanceof DOMDocument) {
+            return $xml;
+        }
+        $dom = new DOMDocument();
+        $dom->preserveWhiteSpace = false;
+        if ($xml instanceof DOMNode) {
+            $xml = $dom->importNode($xml, true);
+            $dom->appendChild($xml);
+            return $dom;
+        }
+
+        if (is_array($xml)) {
+            return self::arrayToXml($dom, $dom, $xml);
+        }
+        if (!empty($xml)) {
+            $dom->loadXML($xml);
+        }
+        return $dom;
+    }
+
+    public static function build(): XmlBuilder
+    {
+        return new XmlBuilder();
+    }
+}

src/Codeception/Util/XmlBuilder.php

@@ -0,0 +1,154 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Codeception\Util;
+
+use DOMDocument;
+use DOMElement;
+use Exception;
+
+/**
+ * That's a pretty simple yet powerful class to build XML structures in jQuery-like style.
+ * With no XML line actually written!
+ * Uses DOM extension to manipulate XML data.
+ *
+ * ```php
+ * <?php
+ * $xml = new \Codeception\Util\XmlBuilder();
+ * $xml->users
+ *    ->user
+ *        ->val(1)
+ *        ->email
+ *            ->val('[email protected]')
+ *            ->attr('valid','true')
+ *            ->parent()
+ *        ->cart
+ *            ->attr('empty','false')
+ *            ->items
+ *                ->item
+ *                    ->val('useful item');
+ *                ->parents('user')
+ *        ->active
+ *            ->val(1);
+ * echo $xml;
+ * ```
+ *
+ * This will produce this XML
+ *
+ * ```xml
+ * <?xml version="1.0"?>
+ * <users>
+ *    <user>
+ *        1
+ *        <email valid="true">[email protected]</email>
+ *        <cart empty="false">
+ *            <items>
+ *                <item>useful item</item>
+ *            </items>
+ *        </cart>
+ *        <active>1</active>
+ *    </user>
+ * </users>
+ * ```
+ *
+ * ### Usage
+ *
+ * Builder uses chained calls. So each call to builder returns a builder object.
+ * Except for `getDom` and `__toString` methods.
+ *
+ *  * `$xml->node` - create new xml node and go inside of it.
+ *  * `$xml->node->val('value')` - sets the inner value of node
+ *  * `$xml->attr('name','value')` - set the attribute of node
+ *  * `$xml->parent()` - go back to parent node.
+ *  * `$xml->parents('user')` - go back through all parents to `user` node.
+ *
+ * Export:
+ *
+ *  * `$xml->getDom` - get a DOMDocument object
+ *  * `$xml->__toString` - get a string representation of XML.
+ *
+ * [Source code](https://github.com/Codeception/Codeception/blob/5.0/src/Codeception/Util/XmlBuilder.php)
+ */
+class XmlBuilder
+{
+    protected DOMDocument $dom;
+
+    protected DOMElement|DOMDocument $currentNode;
+
+    public function __construct()
+    {
+        $this->dom = new DOMDocument();
+        $this->currentNode = $this->dom;
+    }
+
+    /**
+     * Appends child node
+     */
+    public function __get(string $tag): XmlBuilder
+    {
+        $domElement = $this->dom->createElement($tag);
+        $this->currentNode->appendChild($domElement);
+        $this->currentNode = $domElement;
+        return $this;
+    }
+
+    public function val($val): self
+    {
+        $this->currentNode->nodeValue = $val;
+        return $this;
+    }
+
+    /**
+     * Sets attribute for current node
+     */
+    public function attr(string $attr, string $val): self
+    {
+        $this->currentNode->setAttribute($attr, $val);
+        return $this;
+    }
+
+    /**
+     * Traverses to parent
+     */
+    public function parent(): self
+    {
+        $this->currentNode = $this->currentNode->parentNode;
+        return $this;
+    }
+
+    /**
+     * Traverses to parent with $name
+     *
+     * @throws Exception
+     */
+    public function parents(string $tag): self
+    {
+        $traverseNode = $this->currentNode;
+        $elFound = false;
+        while ($traverseNode->parentNode) {
+            $traverseNode = $traverseNode->parentNode;
+            if ($traverseNode->tagName === $tag) {
+                $this->currentNode = $traverseNode;
+                $elFound = true;
+                break;
+            }
+        }
+
+        if (!$elFound) {
+            throw new Exception("Parent {$tag} not found in XML");
+        }
+
+        return $this;
+    }
+
+    public function __toString(): string
+    {
+        return $this->dom->saveXML();
+    }
+
+    public function getDom(): DOMDocument
+    {
+        return $this->dom;
+    }
+}