PHP SOAP 教程-CFANZ编程社区

一、SoapServer 服务器

1、__construct

作用：创建 SoapServer 对象

用法：__construct ( mixed wsdl [, array options] )

参数：wsdl 文件地址，options soap_version，encoding，actor，classmap

返回：对象

2、addFunction

作用：为客户端导出一个或多个函数

用法：addFunction ( mixed functions )

参数：functions 函数，一个或多个，全部 SOAP_FUNCTIONS_ALL

返回：无

3、getFunctions

作用：获取全部函数

用法：getFunctions ()

参数：无

返回：函数数组

4、setClass

作用：导出类中的全部函数

用法：setClass ( string class_name [, mixed args [, mixed ...]])

参数：class_name 类名 args 参数

返回：无

5、setPersistence

作用：允许保存在PHP之间的会话请求数据

用法：setPersistence ( int mode )

参数：mode SOAP_PERSISTENCE_SESSION SOAP_PERSISTENCE_REQUEST

返回：无

6、fault

作用：允许保存在PHP之间的会话请求数据

用法：fault ( string code, string string [, string actor [, mixeddetails [, string name]]] )

参数：code 错误代码 string 简短错误信息 actor 导致错误的字符串 details 错误详细信息

返回：无

7、handle ( [string soap_request] )

作用：处理一个SOAP请求，调用必要的功能，并发送回一个响应。

用法：handle ( [string soap_request] )

参数：soap_request 请求

返回：无

二、SoapClient 客户端

1、__construct

作用：创建 SoapClient 对象

用法：__construct ( mixed wsdl [, array options] )

参数：wsdl 文件地址或 null，

options

a、soap_version soap版本，encoding 编码，compression 压缩，classmap

b、http身份验证：login ， password

c、代理服务：proxy_host, proxy_port, proxy_login and proxy_password

d、证书验证：local_cert ， passphrase

e、wsdl 为null 时：location ， uri

返回：对象

2、__call

作用：调用函数

用法：__call ( string function_name, array arguments [, array options[, array input_headers [, array output_headers]]] )

参数：function_name，arguments

返回：无

3、__doRequest

作用：在执行HTTP请求

用法：__doRequest ( string request, string location, string action,int version [, int one_way] )

参数：request XML的SOAP请求 location 请求地址 action ，version

返回：字符串

4、__getFunctions

作用：获取全部方法

用法：__getFunctions( )

参数：无

返回：函数数组

5、__getFunctions

作用：获取全部方法

用法：__getFunctions( )

参数：无

返回：函数数组

6、__setCookie

作用：设置cookie

用法：__setCookie ( string name [, string value] )

参数：name cookie名称 value cookie值

返回：无

7、__getLastRequest

作用：获取最后的请求

用法：__getLastRequest ()

参数：无

返回：最后的请求

8、__getLastRequestHeaders

作用：获取最后的请求头部信息

用法：__getLastRequestHeaders ()

参数：无

返回：最后的请求头部信息

9、__getLastResponse

作用：获取最后的回应

用法：__getLastRequest ()

参数：无

返回：最后的请求回应

10、__getLastResponseHeaders

作用：获取最后的回应头部信息

用法：__getLastResponseHeaders ()

参数：无

返回：最后的回应头部信息

三、SoapVar 参数

1、__construct

作用：创建 SoapVar 对象

用法：__construct ( mixed data, int encoding [, string type_name [,string type_namespace [, string node_name [, stringnode_namespace]]]] )

参数：data 数据，encoding 编码

返回：参数对象

四、SoapParam 参数

1、__construct

作用：创建 SoapParam 对象

用法：__construct ( mixed data, string name )

参数：data 传递的变量，name 变量的值

返回：参数对象

__construct ( string namespace, string name [, mixed data [,bool mustUnderstand [, mixed actor]]] )

五、SoapHeader 头部

1、__construct

作用：创建 SoapHeade 对象

用法：__construct ( string namespace, string name [, mixed data [,bool mustUnderstand [, mixed actor]]] )

参数： namespace 命名空间 name SOAP 头标签名称，data 头部内容

返回：对象

六、SoapFault 头部

1、__construct

作用：创建 SoapFault 对象

用法：

__construct ( string faultcode, string faultstring [, stringfaultactor [, mixed detail [, string faultname [, SoapHeaderheaderfault]]]] )

参数： faultcode 错误代码，faultstring 错误信息，faultactor 导致错误字符串，detail错误详情

返回：对象

七、例子

1、定义一个类

class  Culculator  
{  
    public   function  sum( $x , $y )  
     {  
         return   $x  +  $y ;  
     }  
}

2、使用Zend Studio生成wsdl文件；

3、SOAP 服务器端 (server.php)

require   './Culculator.php' ;  
  
$server  = newSoapServer( './wps.wsdl' );  
$server ->setClass( 'Culculator' );  
$server ->handle();

require './Culculator.php';

$server = newSoapServer('./wps.wsdl');
$server->setClass('Culculator');
$server->handle();

3、SOAP 客户端(client.php)

$soap  = newSoapClient( './wps.wsdl' );  
echo   $soap ->sum(1,2);  
//运行输出 3