PHP
SOAP-klient

Syntax

• __getFunctions () // Returnerar en rad funktioner för service (endast WSDL-läge)
• __getTypes () // Returnerar array av typer för service (endast WSDL-läge)
• __getLastRequest () // Returnerar XML från den senaste begäran (Kräver trace )
• __getLastRequestHeaders () // Returnerar rubriker från den senaste begäran (Kräver trace )
• __getLastResponse () // Returnerar XML från senaste svaret (Kräver trace )
• __getLastResponseHeaders () // Returnerar rubriker från senaste svaret (Kräver trace )

parametrar

Anmärkningar

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

WSDL-läge

SoapClient ett nytt SoapClient objekt som skickar webbadressen till WSDL-filen och eventuellt en rad alternativ.

// 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
]);

Använd sedan $soap att kalla dina SOAP-metoder.

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

Icke-WSDL-läge

Detta liknar WSDL-läge, förutom att vi passerar NULL som WSDL-fil och ser till att ställa in location och uri alternativ.

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

Classmaps

När du skapar en SOAP-klient i PHP kan du också ställa in en classmap i konfigurationsfältet. Detta classmap definierar vilka typer som definierats i WSDL ska mappas till faktiska klasser istället för standard StdClass . Anledningen till att du vill göra detta är att du kan få automatisk utfyllnad av fält och metodsamtal på dessa klasser istället för att behöva gissa vilka fält som är inställda i det vanliga 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,
    ]
]);

När du har konfigurerat klasskarta, så kommer SoapClient, när du utför en viss operation som returnerar en typ av Address eller Book , att instansera den klassen, fylla fälten med data och returnera den från operationssamtalet.

// 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;

Spåra SOAP-begäran och svar

Ibland vill vi titta på vad som skickas och tas emot i SOAP-begäran. Följande metoder returnerar XML i begäran och svar:

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

Anta till exempel att vi har en ENVIRONMENT och när denna konstants värde är inställt på DEVELOPMENT vill vi återkalla all information när samtalet till getAddress kastar ett fel. En lösning kan vara:

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()
        );
    }
    ...
}