Add configurable charencoding property with getter/setter methods (#144)

Author: Copilot

src/nusoap.php

@@ -396,6 +396,29 @@ function setError($str)
         $this->error_str = $str;
     }
 
+    /**
+     * gets the charencoding setting that controls whether special characters are encoded as XML entities
+     *
+     * @return   boolean
+     * @access   public
+     */
+    function getCharencoding()
+    {
+        return $this->charencoding;
+    }
+
+    /**
+     * sets the charencoding setting
+     *
+     * @param    boolean $charencoding Whether to encode special characters as XML entities in expandEntities()
+     * @return   void
+     * @access   public
+     */
+    function setCharencoding($charencoding)
+    {
+        $this->charencoding = $charencoding;
+    }
+
     /**
      * detect if array is a simple array or a struct (associative array)
      *
@@ -7476,6 +7499,8 @@ function __construct($endpoint, $wsdl = false, $proxyhost = false, $proxyport =
                 $this->endpoint = $this->wsdl->wsdl;
                 $this->wsdlFile = $this->endpoint;
                 $this->debug('existing wsdl instance created from ' . $this->endpoint);
+                // propagate charencoding to wsdl
+                $this->wsdl->setCharencoding($this->charencoding);
                 $this->checkWSDL();
             } else {
                 $this->wsdlFile = $this->endpoint;
@@ -7770,6 +7795,8 @@ function loadWSDL()
         $this->debug('instantiating wsdl class with doc: ' . $this->wsdlFile);
         $this->wsdl = new wsdl('', $this->proxyhost, $this->proxyport, $this->proxyusername, $this->proxypassword, $this->timeout, $this->response_timeout, $this->curl_options, $this->use_curl);
         $this->wsdl->setCredentials($this->username, $this->password, $this->authtype, $this->certRequest);
+        // propagate charencoding to wsdl
+        $this->wsdl->setCharencoding($this->charencoding);
         $this->wsdl->fetchWSDL($this->wsdlFile);
         $this->checkWSDL();
     }

tests/Cases/NusoapBaseTest.phpt

@@ -106,6 +106,36 @@ Toolkit::test(static function (): void {
 	Assert::same('hello & world', $base->expandEntities('hello & world'));
 });
 
+// Test charencoding getter/setter
+Toolkit::test(static function (): void {
+	$base = new nusoap_base();
+
+	// Default should be true
+	Assert::true($base->getCharencoding());
+
+	// Test setting to false
+	$base->setCharencoding(false);
+	Assert::false($base->getCharencoding());
+
+	// Test setting back to true
+	$base->setCharencoding(true);
+	Assert::true($base->getCharencoding());
+});
+
+// Test expandEntities with charencoding disabled
+Toolkit::test(static function (): void {
+	$base = new nusoap_base();
+	$base->setCharencoding(false);
+
+	// When charencoding is false, characters are not converted to XML entities (they remain as literal characters)
+	Assert::same('&', $base->expandEntities('&'));
+	Assert::same('<', $base->expandEntities('<'));
+	Assert::same('>', $base->expandEntities('>'));
+	Assert::same("'", $base->expandEntities("'"));
+	Assert::same('"', $base->expandEntities('"'));
+	Assert::same('hello & world', $base->expandEntities('hello & world'));
+});
+
 // Test isArraySimpleOrStruct
 Toolkit::test(static function (): void {
 	$base = new nusoap_base();