feat(108): Allow client class configuration (#108)

* Allow soap client model configuration

This way, users can overwrite the client model used by the factory,
like so (in a service provider):
```php
SoapFactory::useClientModel(CustomSoapClient::class);
```

* Add test for client configuration

* Update client class property name & add documentation

Author: chiiya

docs/client/configuration.md

@@ -30,3 +30,27 @@ Headers may be added to requests using the `withHeaders` method. This `withHeade
         'X-First' => 'foo',
         'X-Second' => 'bar'
     ])->baseWsdl('http://test.com'/v1?wsdl)->call('Get_Users');
+
+## Custom Client Class
+
+You are free to extend the SOAP client class used internally by this 
+package, by defining your own class and extending the package client:
+
+    use CodeDredd\Soap\SoapClient as BaseClient;
+    
+    class SoapClient extends BaseClient
+    {
+        // ...
+    }
+
+After defining your class, you may instruct the factory to use your 
+custom class. Typically, this will happen in the `boot` method of 
+your application's `App\Providers\AppServiceProvider` class:
+
+    use App\Soap\SoapClient;
+    use CodeDredd\Soap\SoapFactory;
+    
+    public function boot()
+    {
+        SoapFactory::useClientClass(SoapClient::class);
+    }

src/SoapFactory.php

@@ -16,6 +16,13 @@ class SoapFactory
         __call as macroCall;
     }
 
+    /**
+     * The client class name.
+     *
+     * @var string
+     */
+    public static $clientClass = 'CodeDredd\Soap\SoapClient';
+
     /**
      * The stub callables that will handle requests.
      *
@@ -74,7 +81,7 @@ public function __call($method, $parameters)
             return (new SoapTesting($this))->{$method}(...$parameters);
         }
 
-        return tap(new SoapClient($this), function ($request) {
+        return tap($this->client(), function ($request) {
             $request->stub($this->stubCallbacks);
         })->{$method}(...$parameters);
     }
@@ -252,4 +259,24 @@ public function recorded($callback)
             return $callback($pair[0], $pair[1]);
         });
     }
+
+    /**
+     * Get a new client class instance.
+     *
+     * @return SoapClient
+     */
+    public function client()
+    {
+        return new static::$clientClass($this);
+    }
+
+    /**
+     * Set the client class name.
+     *
+     * @param string $clientClass
+     */
+    public static function useClientClass(string $clientClass): void
+    {
+        static::$clientClass = $clientClass;
+    }
 }

tests/Fixtures/CustomSoapClient.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace CodeDredd\Soap\Tests\Fixtures;
+
+use CodeDredd\Soap\SoapClient;
+
+class CustomSoapClient extends SoapClient
+{
+    public function buildClient(string $setup = '')
+    {
+        $this->baseWsdl(__DIR__.'/Wsdl/weather.wsdl');
+        $this->withHandlerOptions([
+            'handler' => $this->buildHandlerStack(),
+        ]);
+        $this->refreshEngine();
+        $this->isClientBuilded = true;
+
+        return $this;
+    }
+}

tests/Unit/SoapClientTest.php

@@ -5,6 +5,9 @@
 use CodeDredd\Soap\Client\Request;
 use CodeDredd\Soap\Client\Response;
 use CodeDredd\Soap\Facades\Soap;
+use CodeDredd\Soap\SoapClient;
+use CodeDredd\Soap\SoapFactory;
+use CodeDredd\Soap\Tests\Fixtures\CustomSoapClient;
 use CodeDredd\Soap\Tests\TestCase;
 
 class SoapClientTest extends TestCase
@@ -122,4 +125,14 @@ public function soapActionProvider()
             'with_fake_string' => ['Get_Post', $fakeResponse, ['response' => 'Test']],
         ];
     }
+
+    public function testSoapClientClassMayBeCustomized(): void
+    {
+        Soap::fake();
+        $client = Soap::buildClient('laravel_soap');
+        $this->assertInstanceOf(SoapClient::class, $client);
+        SoapFactory::useClientClass(CustomSoapClient::class);
+        $client = Soap::buildClient('laravel_soap');
+        $this->assertInstanceOf(CustomSoapClient::class, $client);
+    }
 }