PHP
Cliente de jabón

Sintaxis

• __getFunctions () // Devuelve la matriz de funciones para el servicio (solo en modo WSDL)
• __getTypes () // Devuelve una matriz de tipos para el servicio (solo en modo WSDL)
• __getLastRequest () // Devuelve XML de la última solicitud (requiere la opción de trace )
• __getLastRequestHeaders () // Devuelve los encabezados de la última solicitud (requiere la opción de trace )
• __getLastResponse () // Devuelve XML de la última respuesta (requiere la opción de trace )
• __getLastResponseHeaders () // Devuelve los encabezados de la última respuesta (requiere la opción de trace )

Parámetros

Observaciones

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

Modo WSDL

Primero, cree un nuevo objeto SoapClient , pasando la URL al archivo WSDL y, opcionalmente, una variedad de opciones.

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

Luego usa el objeto $soap para llamar a tus métodos SOAP.

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

Modo no WSDL

Esto es similar al modo WSDL, excepto que pasamos NULL como el archivo WSDL y nos aseguramos de establecer la location y las opciones de uri .

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

Mapas de clase

Al crear un cliente SOAP en PHP, también puede establecer una clave de classmap en la matriz de configuración. Este classmap define qué tipos definidos en el WSDL deben asignarse a clases reales, en lugar del StdClass predeterminado. La razón por la que querría hacer esto es porque puede completar automáticamente los campos y las llamadas a métodos en estas clases, en lugar de tener que adivinar qué campos se configuran en la StdClass regular.

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

Después de configurar el mapa de clase, siempre que realice una determinada operación que devuelva un tipo de Address o Book , SoapClient creará una instancia de esa clase, llenará los campos con los datos y los devolverá desde la llamada de la operación.

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

Rastreo de solicitud y respuesta SOAP

A veces queremos ver lo que se envía y recibe en la solicitud de SOAP. Los siguientes métodos devolverán el XML en la solicitud y respuesta:

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

Por ejemplo, supongamos que tenemos una constante de ENVIRONMENT y cuando el valor de esta constante se establece en DEVELOPMENT , queremos repetir toda la información cuando la llamada a getAddress un error. Una solución podría ser:

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