Allow configuration of libxml options for decoding XML

Author: veewee

src/Encoder/Method/ResponseEncoder.php

@@ -101,7 +101,7 @@ private function decode(MethodContext $context, string $xml): array
         // The SoapResponse only contains the payload of the response (with no headers).
         // It can be parsed directly as XML.
         invariant($xml !== '', 'Expected a non-empty response payload. Received an empty HTTP response');
-        $parts = (new OperationReader($meta))($xml)->elements();
+        $parts = (new OperationReader($meta))($xml, $context->registry->decoderLibXmlOptions())->elements();
 
         return map(
             $parts,

src/EncoderRegistry.php

@@ -26,10 +26,12 @@ final class EncoderRegistry
     /**
      * @param MutableMap<string, XmlEncoder<mixed, string>> $simpleTypeMap
      * @param MutableMap<string, XmlEncoder<mixed, string>> $complextTypeMap
+     * @param int $decoderLibXmlOptions - bitmask of LIBXML_* constants https://www.php.net/manual/en/libxml.constants.php
      */
     private function __construct(
         private MutableMap $simpleTypeMap,
-        private MutableMap $complextTypeMap
+        private MutableMap $complextTypeMap,
+        private int $decoderLibXmlOptions = 0,
     ) {
     }
 
@@ -341,4 +343,22 @@ public function detectEncoderForContext(Context $context): XmlEncoder
     {
         return EncoderDetector::default()($context);
     }
+
+    /**
+     * @param int $libXmlOptions - bitmask of LIBXML_* constants https://www.php.net/manual/en/libxml.constants.php
+     */
+    public function setDecoderLibXmlOptions(int $libXmlOptions): self
+    {
+        $this->decoderLibXmlOptions = $libXmlOptions;
+
+        return $this;
+    }
+
+    /**
+     * @return int - bitmask of LIBXML_* constants https://www.php.net/manual/en/libxml.constants.php
+     */
+    public function decoderLibXmlOptions(): int
+    {
+        return $this->decoderLibXmlOptions;
+    }
 }

src/Xml/Reader/OperationReader.php

@@ -22,14 +22,15 @@ public function __construct(
      * Reads all operation response message parts:
      *
      * @param non-empty-string $xml
+     * @param int $libXmlOptions - bitmask of LIBXML_* constants https://www.php.net/manual/en/libxml.constants.php
      */
-    public function __invoke(string $xml): ElementList
+    public function __invoke(string $xml, int $libXmlOptions = 0): ElementList
     {
         $bindingStyle = BindingStyle::tryFrom($this->meta->bindingStyle()->unwrapOr(BindingStyle::DOCUMENT->value));
 
         // The Response can contain out of multiple response parts.
         // Therefore, it is being wrapped by a central root element:
-        $body = (new SoapEnvelopeReader())($xml);
+        $body = (new SoapEnvelopeReader())($xml, $libXmlOptions);
         $bodyElement = $body->element();
 
         $elements = match($bindingStyle) {

src/Xml/Reader/SoapEnvelopeReader.php

@@ -8,15 +8,18 @@
 use Soap\Xml\Locator\SoapBodyLocator;
 use VeeWee\Xml\Dom\Document;
 use function VeeWee\Xml\Dom\Assert\assert_element;
+use function VeeWee\Xml\Dom\Configurator\loader;
+use function VeeWee\Xml\Dom\Loader\xml_string_loader;
 
 final class SoapEnvelopeReader
 {
     /**
      * @param non-empty-string $xml
+     * @param int $libXmlOptions - bitmask of LIBXML_* constants https://www.php.net/manual/en/libxml.constants.php
      */
-    public function __invoke(string $xml): Element
+    public function __invoke(string $xml, int $libXmlOptions = 0): Element
     {
-        $envelope = Document::fromXmlString($xml);
+        $envelope = Document::configure(loader(xml_string_loader($xml, $libXmlOptions)));
 
         // Make sure it does not contain a fault response before parsing the body parts.
         (new SoapFaultGuard())($envelope);

tests/Unit/Xml/Reader/OperationReaderTest.php

@@ -17,10 +17,10 @@
 final class OperationReaderTest extends TestCase
 {
     #[DataProvider('provideEnvelopeCases')]
-    public function test_it_can_read_a_soap_envelope(MethodMeta $meta, string $envelope, array $expected): void
+    public function test_it_can_read_a_soap_envelope(MethodMeta $meta, string $envelope, array $expected, int $libXmlOptions = 0): void
     {
         $reader = new OperationReader($meta);
-        $actual = $reader($envelope);
+        $actual = $reader($envelope, $libXmlOptions);
 
         static::assertSame(
             $expected,
@@ -91,5 +91,19 @@ public static function provideEnvelopeCases()
                 '<c>c</c>',
             ],
         ];
+
+        yield 'xml-options' => [
+            $methodMeta->withBindingStyle(BindingStyle::DOCUMENT->value),
+            <<<EOXML
+                <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
+                    <soap:Body xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/">
+                        <Request><![CDATA[content]]></Request>
+                    </soap:Body>
+                </soap:Envelope>
+            EOXML,
+            ['<Request>content</Request>'],
+            \LIBXML_NOCDATA
+        ];
+
     }
 }

tests/Unit/Xml/Reader/SoapEnvelopeReaderTest.php

@@ -19,10 +19,10 @@
 final class SoapEnvelopeReaderTest extends TestCase
 {
     #[DataProvider('provideEnvelopeCases')]
-    public function test_it_can_read_a_soap_envelope(SoapVersion $version, string $envelope, string $expected): void
+    public function test_it_can_read_a_soap_envelope(SoapVersion $version, string $envelope, string $expected, int $libXmlOptions = 0): void
     {
         $reader = new SoapEnvelopeReader();
-        $actual = $reader($envelope);
+        $actual = $reader($envelope, $libXmlOptions);
 
         static::assertXmlStringEqualsXmlString($expected, $actual->value());
     }
@@ -83,5 +83,22 @@ public static function provideEnvelopeCases()
                 </soap:Body>
             EOXML,
         ];
+
+        yield 'xml-options' => [
+            SoapVersion::SOAP_12,
+            <<<EOXML
+                <soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap12/">
+                    <soap:Body xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap12/">
+                        <Request><![CDATA[content]]></Request>
+                    </soap:Body>
+                </soap:Envelope>
+            EOXML,
+            <<<EOXML
+                <soap:Body xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap12/">
+                    <Request>content</Request>
+                </soap:Body>
+            EOXML,
+            \LIBXML_NOCDATA
+        ];
     }
 }