La funcionalidad de SOAP implementada dentro de Zend Framework tiene como objetivo simplificar todos los pasos necesarios para las comunicaciones SOAP.

SOAP es un protocolo independiente del lenguaje. Por lo tanto, puede utilizarse no solo para comunicaciones PHP-a-PHP.

Existen tres configuraciones para aplicaciones SOAP en las que Zend Framework puede utilizarse:

Siempre necesitamos saber qué funcionalidad proporciona el servidor SOAP para poder operar con él. WSDL se utiliza para describir en detalle la API del servicio de red.

El lenguaje WSDL es lo suficientemente complejo (consulte http://www.w3.org/TR/wsdl para más detalles). Por eso resulta difícil preparar una descripción WSDL correcta.

Otro problema es sincronizar los cambios en la API del servicio de red con un WSDL ya existente.

Ambos problemas pueden resolverse mediante la autogeneración de WSDL. Un requisito previo para esto es un servidor de autodetección SOAP. Este construye un objeto similar al objeto utilizado en la aplicación servidor SOAP, extrae la información necesaria y genera el WSDL correcto utilizando esa información.

Hay dos formas de utilizar Zend Framework para una aplicación servidor SOAP:

Ambos métodos son compatibles con la funcionalidad de Autodiscovery de Zend Framework.

La clase Zend_Soap_AutoDiscover también admite el mapeo de tipos de datos de PHP a tipos XSD.

A continuación se muestra un ejemplo de uso común de la funcionalidad de autodetección. La función handle() genera el archivo WSDL y lo envía al navegador.

class My_SoapServer_Class {
...
}

$autodiscover = new Zend_Soap_AutoDiscover();
$autodiscover->setClass('My_SoapServer_Class');
$autodiscover->handle();

Si necesita acceder al archivo WSDL generado, ya sea para guardarlo en un archivo o como una cadena XML, puede utilizar las funciones dump($filename) o toXml() que proporciona la clase AutoDiscover.

Si se utiliza una clase para proporcionar la funcionalidad del servidor SOAP, entonces la misma clase debe proporcionarse a Zend_Soap_AutoDiscover para la generación del WSDL:

$autodiscover = new Zend_Soap_AutoDiscover();
$autodiscover->setClass('My_SoapServer_Class');
$autodiscover->handle();

Se utilizan las siguientes reglas durante la generación del WSDL:

Si se utiliza un conjunto de funciones para proporcionar la funcionalidad del servidor SOAP, entonces el mismo conjunto debe proporcionarse a Zend_Soap_AutoDiscovery para la generación del WSDL:

$autodiscover = new Zend_Soap_AutoDiscover();
$autodiscover->addFunction('function1');
$autodiscover->addFunction('function2');
$autodiscover->addFunction('function3');
...
$autodiscover->handle();

Se utilizan las siguientes reglas durante la generación del WSDL:

Los tipos de datos de entrada/salida se convierten en tipos del servicio de red utilizando el siguiente mapeo:

Donde xsd: es el espacio de nombres "http://www.w3.org/2001/XMLSchema", soap-enc: es el espacio de nombres "http://schemas.xmlsoap.org/soap/encoding/", tns: es el "espacio de nombres de destino" de un servicio.

WSDL ofrece diferentes mecanismos de transporte y estilos. Esto afecta a las etiquetas soap:binding y soap:body dentro de la sección Binding del WSDL. Diferentes clientes tienen diferentes requisitos en cuanto a qué opciones realmente funcionan. Por lo tanto, puede establecer los estilos antes de llamar a cualquier método setClass o addFunction de la clase AutoDiscover.

$autodiscover = new Zend_Soap_AutoDiscover();
// Default is 'use' => 'encoded' and
// 'encodingStyle' => 'http://schemas.xmlsoap.org/soap/encoding/'
$autodiscover->setOperationBodyStyle(
                    array('use' => 'literal',
                          'namespace' => 'http://framework.zend.com')
                );

// Default is 'style' => 'rpc' and
// 'transport' => 'http://schemas.xmlsoap.org/soap/http'
$autodiscover->setBindingStyle(
                    array('style' => 'document',
                          'transport' => 'http://framework.zend.com')
                );
...
$autodiscover->addFunction('myfunc1');
$autodiscover->handle();