PHP
SOAP-Client

Syntax

• __getFunctions () // Gibt ein Array von Funktionen für den Service zurück (nur WSDL-Modus)
• __getTypes () // Gibt ein Array von Typen für den Service zurück (nur WSDL-Modus)
• __getLastRequest () // Gibt XML von der letzten Anforderung zurück (Option für trace erforderlich)
• __getLastRequestHeaders () // Header von den letzten Anfrage Returns (Erfordert trace - Option)
• __getLastResponse () // Gibt XML aus der letzten Antwort zurück (Option für trace erforderlich)
• __getLastResponseHeaders () // Gibt die Header der letzten Antwort zurück (Option für trace erforderlich)

Parameter

Bemerkungen

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

WSDL-Modus

Erstellen Sie zunächst ein neues SoapClient Objekt, und übergeben Sie die URL an die WSDL-Datei und optional ein Array von Optionen.

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

Rufen Sie dann mit dem $soap Objekt Ihre SOAP-Methoden auf.

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

Nicht-WSDL-Modus

Dies ist dem WSDL-Modus ähnlich, mit der Ausnahme, dass wir NULL als WSDL-Datei übergeben und die location und uri Optionen festlegen.

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

Klassenpläne

Beim Erstellen eines SOAP-Clients in PHP können Sie auch einen classmap Schlüssel im Konfigurationsarray classmap . Diese classmap definiert, welche Typen in der WSDL anstelle der standardmäßigen StdClass tatsächlichen Klassen zugeordnet werden StdClass . Der Grund, warum Sie dies tun möchten, ist, dass Sie die automatische Vervollständigung von Feldern und Methodenaufrufen für diese Klassen erhalten können, anstatt zu erraten, welche Felder für die reguläre 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,
    ]
]);

Nach der Konfiguration der Classmap wird der SoapClient bei jeder Ausführung einer bestimmten Operation, die einen Typ Address oder Book zurückgibt, diese Klasse instanziieren, die Felder mit den Daten füllen und sie vom Operationsaufruf zurückgeben.

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

Verfolgung der SOAP-Anforderung und -Antwort

Manchmal möchten wir uns ansehen, was in der SOAP-Anfrage gesendet und empfangen wird. Die folgenden Methoden geben das XML in der Anforderung und der Antwort zurück:

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

Angenommen, wir haben eine ENVIRONMENT Konstante. Wenn der Wert dieser Konstante auf DEVELOPMENT , möchten wir alle Informationen getAddress wenn der Aufruf von getAddress einen Fehler getAddress . Eine Lösung könnte sein:

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