WSDL how to set target namespace independent of the service execution url

Question

I have to set a SOAP server under PHP and I've get it working, but because I need to maintain separate states from development, stage and production, it needs to have all real urls out of the wsdl. I have search a lot of documentation but any example I got have target urls in wsdl, and I finish the following working wsdl



  
    
      
        
            
               How to use the server
           
           
             
             
             
             
             
             
             
             
             
             
             
         
     
 
 
    
       Response: Error or Success
   
   
      
        
    



    
       General information
   
   
    
    
    
    
    
    
    
    
    
    



    
       Item information
   
   
       
       
       
       
       
       
       
   


    
       Array de items que integran la OC
   
   
     
 




    


    


    
      
      
  


 
    
        
           
               
           
           
               
           
       
   
   
    Orders creation service

The point is that this design, although it works, does not satisfy the need to separate the execution urls from the WSDL sheet, so when going from stage to production I must modify the wsdl and that should not happen, because the requirement is to keep WSDL immutable.

Somebody told me that you can set the urls in the http header but I can't understand how that alternative would work.

I would greatly appreciate any help at this point. Thanks in advance.

user_2215241 · Answer

I had the same problem some time ago. In a development team we discussed possible solutions. One promising approach was to work with placeholders. I assume that you have a controller where your soap server is initialized. Even before initialization, you can check what the request URL is. Based on this request URL, the WSDL can then be parsed and adjusted accordingly.

Let us assume that your service location is a placeholder.


    Orders creation service

In your controller you do something like this ...

class SoapServerController
{
    ...
    public function initAction(): void
    {
        // check the request uri
        $requestUri = $_SERVER['REQUEST_URI'];

        switch ($requestUri) {
            case 'yadda' :
                $environment = 'staging';
                $locationUri = 'https://example.com/A';
                break;
            case 'blubb' :
                $environment = 'production';
                $locationUri = 'https://example.com/B';
                break;
            default :
                $environment = 'test';
                 $locationUri = 'https://example.com/C';
                 break;
        }

        // rewrite the wsdl
        $doc = new DOMDocument();
        $doc->loadXML('https://some.location.tld/inital.wsdl');

        $address = $doc->getElementsByTagNameNS('http://schemas.xmlsoap.org/wsdl/soap/', 'address');
        $adress->setAttribute('location', $locationUri);
        
        $filename = PATH_TO_WSDL_FOLDER . '/' . $environment . '.wsdl';
        $doc->save($filename);

        // is the wsdl get parameter set?
        if (isset($_GET['wsdl'])) {
            echo $doc->saveXML();
            exit();
        }

        // initialize the soap server
        $service = new SoapService();
        $server = new SoapServer($filename, []);
        $server->setObject($service);
        $server->handle();
    }
}

Please remember that this is only sample code that has not been tested. However, the team decided to create one WSDL file per environment and to abandon the logic, because writing a new WSDL file per request would be too much technical debt. Even when a cache system was used. We have opted for speed and maintainable, simple code. I don 't know how much environments you have to deal with. For us it was easier to deal with four different wsdl files.

WSDL how to set target namespace independent of the service execution url

1 Answers