PHP
SOAP क्लाइंट

वाक्य - विन्यास

• __getFunctions () // सेवा के लिए कार्यों का रिटर्न सरणी (केवल WSDL मोड)
• __getTypes () // सेवा के लिए प्रकार की रिटर्न सरणी (केवल WSDL मोड)
• __getLastRequest () // अंतिम अनुरोध से XML लौटाता है ( trace विकल्प की आवश्यकता है)
• __getLastRequestHeaders () // अंतिम अनुरोध से हेडर लौटाता है ( trace विकल्प की आवश्यकता है)
• __getLastResponse () // अंतिम प्रतिक्रिया से एक्सएमएल लौटाता है ( trace विकल्प की आवश्यकता है)
• __getLastResponseHeaders () // अंतिम प्रतिक्रिया से हेडर लौटाता है ( trace विकल्प की आवश्यकता है)

पैरामीटर

टिप्पणियों

$soap->requestInfo(['a', 'b', 'c']);

डब्लूएसडीएल मोड

सबसे पहले, एक नई SoapClient ऑब्जेक्ट बनाएं, URL को WSDL फ़ाइल में पास करें और वैकल्पिक रूप से, विकल्पों की एक सरणी।

// Create a new client object using a WSDL URL
$soap = new SoapClient('https://example.com/soap.wsdl', [
    # This array and its values are optional
    'soap_version' => SOAP_1_2,
    'compression' => SOAP_COMPRESSION_ACCEPT | SOAP_COMPRESSION_GZIP,
    'cache_wsdl' => WSDL_CACHE_BOTH,
    # Helps with debugging
    'trace' => TRUE,
    'exceptions' => TRUE
]);

फिर अपने SOAP तरीकों को कॉल करने के लिए $soap ऑब्जेक्ट का उपयोग करें।

$result = $soap->requestData(['a', 'b', 'c']);

गैर-डब्ल्यूएसडीएल मोड

यह WSDL मोड के समान है, सिवाय इसके कि हम NULL को WSDL फ़ाइल के रूप में पास करें और location और uri विकल्पों को सेट करना सुनिश्चित करें।

$soap = new SoapClient(NULL, [
    'location' => 'https://example.com/soap/endpoint',
    'uri' => 'namespace'
]);

Classmaps

PHP में SOAP क्लाइंट बनाते समय, आप कॉन्फ़िगरेशन सरणी में एक classmap कुंजी भी सेट कर सकते हैं। यह classmap परिभाषित करता है कि classmap परिभाषित किस प्रकार को डिफ़ॉल्ट StdClass बजाय वास्तविक कक्षाओं में मैप किया जाना चाहिए। आप ऐसा करना चाहते हैं इसका कारण यह है कि आप इन वर्गों पर स्वतः-पूर्णता और विधि कॉल प्राप्त कर सकते हैं, बजाय यह अनुमान लगाने के कि कौन से फ़ील्ड नियमित StdClass पर सेट हैं।

class MyAddress {
    public $country;
    public $city;
    public $full_name;
    public $postal_code; // or zip_code
    public $house_number;
}

class MyBook {
    public $name;
    public $author;

    // The classmap also allows us to add useful functions to the objects
    // that are returned from the SOAP operations.
    public function getShortDescription() {
        return "{$this->name}, written by {$this->author}";
    }
}

$soap_client = new SoapClient($link_to_wsdl, [
    // Other parameters
    "classmap" => [
        "Address" => MyAddress::class, // ::class simple returns class as string
        "Book" => MyBook::class,
    ]
]);

सहपाठी को कॉन्फ़िगर करने के बाद, जब भी आप एक निश्चित ऑपरेशन करते हैं जो एक प्रकार का Address या Book लौटाता है, तो SoapClient उस वर्ग को तुरंत हटा देगा, डेटा के साथ फ़ील्ड भरें और ऑपरेशन कॉल से इसे वापस कर दें।

// Lets assume 'getAddress(1234)' returns an Address by ID in the database
$address = $soap_client->getAddress(1234);

// $address is now of type MyAddress due to the classmap
echo $address->country;

// Lets assume the same for 'getBook(1234)'
$book = $soap_client->getBook(124);

// We can not use other functions defined on the MyBook class
echo $book->getShortDescription();

// Any type defined in the WSDL that is not defined in the classmap
// will become a regular StdClass object
$author = $soap_client->getAuthor(1234);

// No classmap for Author type, $author is regular StdClass.
// We can still access fields, but no auto-completion and no custom functions
// to define for the objects.
echo $author->name;

SOAP अनुरोध और प्रतिक्रिया ट्रेस करना

कभी-कभी हम यह देखना चाहते हैं कि SOAP अनुरोध में क्या भेजा और प्राप्त किया गया है। अनुरोध और प्रतिक्रिया में XML निम्नलिखित तरीके लौटाएगा:

SoapClient::__getLastRequest()
SoapClient::__getLastRequestHeaders()
SoapClient::__getLastResponse()
SoapClient::__getLastResponseHeaders()

उदाहरण के लिए, मान लें कि हमारे पास एक ENVIRONMENT स्थिरांक है और जब इस स्थिरांक का मान DEVELOPMENT लिए सेट हो जाता है, तो जब getAddress कॉल में कोई त्रुटि होती है, तो हम सभी जानकारी को प्रतिध्वनित करना चाहते हैं। एक समाधान हो सकता है:

try {
    $address = $soap_client->getAddress(1234);
} catch (SoapFault $e) {
    if (ENVIRONMENT === 'DEVELOPMENT') {
        var_dump(
            $soap_client->__getLastRequestHeaders()
            $soap_client->__getLastRequest(),
            $soap_client->__getLastResponseHeaders(),
            $soap_client->__getLastResponse()
        );
    }
    ...
}