PHP教程:WebService最常用的两种方法

 国内用PHP写WebService的真的很少,网上资料也没多少,公司的项目开发过程中,经历了不少这方面的东西,写出来以供大家参考(谢谢老农提供的WSDL和程序文件)

  客户端

  代码:

01.  
  
02.header ( "Content-Type: text/html; charset=utf-8" );
  
03./*
  
04.* 指定WebService路径并初始化一个WebService客户端
  
05.*/
  
06.$ws ="http://soap/soapCspMessage.php?wsdl";
  
07.$client =new SoapClient ( $ws, array ('trace' => 1, 'uri' => 'http://www.zxsv.com/SoapDiscovery/' ) );
  08./*
  
09.* 获取SoapClient对象引用的服务所提供的所有方法
  
10.*/
  
11.echo ("SOAP服务器提供的开放函数:");
  
12.echo ('
'
);
  13.var_dump ( $client->__getFunctions () );
  
14.echo ('
'
);
  15.echo ("SOAP服务器提供的Type:");
  
16.echo ('
'
);
  17.var_dump ( $client->__getTypes () );
  
18.echo ('
'
);
  19.echo ("执行GetGUIDNode的结果:");
  
20.//$users = $client->GetUsers();
  
21.//var_dump($HelloWorld );
  
22.$parameters =array('uname'=>'zxsv',"upassword"=>'123');
  23.$out = $client->HelloWorld($parameters);
  
24.$datadb = $out->HelloWorldResponse;
  
25.var_dump($out);
  
26.?>

  服务端

  代码:

 

01.  
  
02.class Member
  
03.{
  
04.public $UserId;
  
05.public $Name;
  
06.public function __construct($parmas){
  
07.$this->UserId = $parmas[0];
  
08.$this->Name = $parmas[1];
  
09.}
  
10.}
  
11.$servidorSoap =new SoapServer('testphp.XML',array('uri' => 'http://www.TestPHP.com/','encoding'=>'utf-8','soap_version' => SOAP_1_2 ));
  12.$servidorSoap->setClass(Testphp);
  
13.$servidorSoap->handle();
  
14.class Testphp {
  
15.public function HelloWorld($uid){
  
16.return array('HelloWorldResult'=>"mystring".$uid->{'uname'}.' and '.$uid->{'upassword'});
  17.}
  
18.public function GetMember($uid){
  
19.$s=array();
  
20.for($i=0;$i<$uid->{'uid'};$i++){
  21.$s[] =&new Member(array($i, $uid->{'uname'}.'我测试'.$i));
  22.}
  
23.return array('GetMemberResult'=>$s);
  24.}
  
25.}
  
26.?>

  到这里应该都看的懂吧

  下面是WSDL文件

  代码:

 

001.<?xml version="1.0" encoding="utf-8"?>
002.<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:tns="http://www.TestPHP.com/" xmlns:s="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" targetNamespace="http://www.TestPHP.com/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
003.<wsdl:types>
004.<s:schema elementFormDefault="qualified" targetNamespace="http://www.TestPHP.com/">
005.<s:element name="HelloWorld">
006.<s:complexType>
007.<s:sequence>
008.<s:element minOccurs="0" maxOccurs="1" name="uname" type="s:string"/>
009.<s:element minOccurs="0" maxOccurs="1" name="upassword" type="s:string"/>
010.</s:sequence>
011.</s:complexType>
012.</s:element>
013.<s:element name="HelloWorldResponse">
014.<s:complexType>
015.<s:sequence>
016.<s:element minOccurs="0" maxOccurs="1" name="HelloWorldResult" type="s:string"/>
017.</s:sequence>
018.</s:complexType>
019.</s:element>
020.<s:element name="GetMember">
021.<s:complexType>
022.<s:sequence>
023.<s:element minOccurs="1" maxOccurs="1" name="uid" type="s:int"/>
024.<s:element minOccurs="0" maxOccurs="1" name="uname" type="s:string"/>
025.</s:sequence>
026.</s:complexType>
027.</s:element>
028.<s:element name="GetMemberResponse">
029.<s:complexType>
030.<s:sequence>
031.<s:element minOccurs="0" maxOccurs="1" name="GetMemberResult" type="tns:ArrayOfMember"/>
032.</s:sequence>
033.</s:complexType>
034.</s:element>
035.<s:complexType name="ArrayOfMember">
036.<s:sequence>
037.<s:element minOccurs="0" maxOccurs="unbounded" name="Member" nillable="true" type="tns:Member"/>
038.</s:sequence>
039.</s:complexType>
040.<s:complexType name="Member">
041.<s:sequence>
042.<s:element minOccurs="1" maxOccurs="1" name="UserId" type="s:int"/>
043.<s:element minOccurs="0" maxOccurs="1" name="Name" type="s:string"/>
044.</s:sequence>
045.</s:complexType>
046.</s:schema>
047.</wsdl:types>
048.<wsdl:message name="HelloWorldSoapIn">
049.<wsdl:part name="parameters" element="tns:HelloWorld"/>
050.</wsdl:message>
051.<wsdl:message name="HelloWorldSoapOut">
052.<wsdl:part name="parameters" element="tns:HelloWorldResponse"/>
053.</wsdl:message>
054.<wsdl:message name="GetMemberSoapIn">
055.<wsdl:part name="parameters" element="tns:GetMember"/>
056.</wsdl:message>
057.<wsdl:message name="GetMemberSoapOut">
058.<wsdl:part name="parameters" element="tns:GetMemberResponse"/>
059.</wsdl:message>
060.<wsdl:portType name="TestPHPSoap">
061.<wsdl:operation name="HelloWorld">
062.<wsdl:input message="tns:HelloWorldSoapIn"/>
063.<wsdl:output message="tns:HelloWorldSoapOut"/>
064.</wsdl:operation>
065.<wsdl:operation name="GetMember">
066.<wsdl:input message="tns:GetMemberSoapIn"/>
067.<wsdl:output message="tns:GetMemberSoapOut"/>
068.</wsdl:operation>
069.</wsdl:portType>
070.<wsdl:binding name="TestPHPSoap" type="tns:TestPHPSoap">
071.<soap:binding transport="http://schemas.xmlsoap.org/soap/http"/>
072.<wsdl:operation name="HelloWorld">
073.<soap:operation soapAction="http://www.TestPHP.com/HelloWorld"   />
074.<wsdl:input>
075.<soap:body use="literal"/>
076.</wsdl:input>
077.<wsdl:output>
078.<soap:body use="literal"/>
079.</wsdl:output>
080.</wsdl:operation>
081.<wsdl:operation name="GetMember">
082.<soap:operation soapAction="http://www.TestPHP.com/GetMember"  />
083.<wsdl:input>
084.<soap:body use="literal"/>
085.</wsdl:input>
086.<wsdl:output>
087.<soap:body use="literal"/>
088.</wsdl:output>
089.</wsdl:operation>
090.</wsdl:binding>
091.<wsdl:binding name="TestPHPSoap12" type="tns:TestPHPSoap">
092.<soap12:binding transport="http://schemas.xmlsoap.org/soap/http"/>
093.<wsdl:operation name="HelloWorld">
094.<soap12:operation soapAction="http://www.TestPHP.com/HelloWorld"  />
095.<wsdl:input>
096.<soap12:body use="literal"/>
097.</wsdl:input>
098.<wsdl:output>
099.<soap12:body use="literal"/>
100.</wsdl:output>
101.</wsdl:operation>
102.<wsdl:operation name="GetMember">
103.<soap12:operation soapAction="http://www.TestPHP.com/GetMember"  />
104.<wsdl:input>
105.<soap12:body use="literal"/>
106.</wsdl:input>
107.<wsdl:output>
108.<soap12:body use="literal"/>
109.</wsdl:output>
110.</wsdl:operation>
111.</wsdl:binding>
112.<wsdl:service name="TestPHP">
113.<wsdl:port name="TestPHPSoap" binding="tns:TestPHPSoap">
114.<soap:address location="http://soap/goodwsdl/testphp.php"/>
115.</wsdl:port>
116.<wsdl:port name="TestPHPSoap12" binding="tns:TestPHPSoap12">
117.<soap12:address location="http://soap/goodwsdl/testphp.php"/>
118.</wsdl:port>
119.</wsdl:service>
120.</wsdl:definitions>

 

  这里有返回的两个字段,一个是返回字符串,这个很好理解

 

01.<s:element name="HelloWorld">
02.<s:complexType>
03.<s:sequence>
04.<s:element minOccurs="0" maxOccurs="1" name="uname" type="s:string"/>
05.<s:element minOccurs="0" maxOccurs="1" name="upassword" type="s:string"/>
06.</s:sequence>
07.</s:complexType>
08.</s:element>
09.<s:element name="HelloWorldResponse">
10.<s:complexType>
11.<s:sequence>
12.<s:element minOccurs="0" maxOccurs="1" name="HelloWorldResult" type="s:string"/>
13.</s:sequence>
14.</s:complexType>
15.</s:element>

  这一段就字符串的

  那返回数组的就比较麻烦了,我和老农搞了一两周才发现是WSDL文件写错了,看下面的一段

 

01.<s:element name="GetMember">
02.<s:complexType>
03.<s:sequence>
04.<s:element minOccurs="1" maxOccurs="1" name="uid" type="s:int"/>
05.<s:element minOccurs="0" maxOccurs="1" name="uname" type="s:string"/>
06.</s:sequence>
07.</s:complexType>
08.</s:element>
09.<s:element name="GetMemberResponse">
10.<s:complexType>
11.<s:sequence>
12.<s:element minOccurs="0" maxOccurs="1" name="GetMemberResult" type="tns:ArrayOfMember"/>
13.</s:sequence>
14.</s:complexType>
15.</s:element>
16.<s:complexType name="ArrayOfMember">
17.<s:sequence>
18.<s:element minOccurs="0" maxOccurs="unbounded" name="Member" nillable="true" type="tns:Member"/>
19.</s:sequence>
20.</s:complexType>
21.<s:complexType name="Member">
22.<s:sequence>
23.<s:element minOccurs="1" maxOccurs="1" name="UserId" type="s:int"/>
24.<s:element minOccurs="0" maxOccurs="1" name="Name" type="s:string"/>
25.</s:sequence>
26.</s:complexType>

  第一段GetMember是输入,最重要的是GetMemberResponse这段,看type=”tns:ArrayOfMember”这里,返回一 个数组,WSDL中定义了ArrayOf这个,后面的就简单了,ArrayOfMember的类型是type=”tns:Member” ,从name=”Member”得到要返回的数组,完工。

 

  Ping Service,博客程序提供一种通知机制,以便在第一时间将博客的更新信息发布到提供Ping Service服务的网站,写聚合的时候研究了一下

  先看标准吧

  这是一个标准的Ping Service,用XMLRPC来传数据的,注释写的这么详细,代码说明就不需要了吧,PHP5开启XMLRPC方法

  client.php

  代码:

 

01.  
  
02.$host ='zxsv';
  03.$port =80;
  
04.$rpc_server ='/test/xmlrpc_server.php';
  05.$title ='zxsv';
  06.$server ='http://zxsv/test/';
  07.$rss ='http://zxsv/test/rss.php';
  08.//WeblogUpdates.Ping方法
  
09.$Ping = xmlrpc_encode_request('weblogUpdates.Ping', array($title, $server ));
  10.//weblogUpdates.extendedPing方法
  
11.$extendedPing = xmlrpc_encode_request('weblogUpdates.extendedPing', array($title, $server, $rss ));
  12.//调用rpc_client_call函数把所有请求发送给XML-RPC服务器端后获取信息
  
13.$response = rpc_client_call($host, $port, $rpc_server, $Ping);
  
14.$split='';
  15.$xml = explode($split, $response);
  
16.$xml = $split . array_pop($xml);
  
17.$response = xmlrpc_decode($xml);
  
18.//输出从RPC服务器端获取的信息
  
19.print_r($response);
  
20./**
  
21.* 函数:提供给客户端进行连接XML-RPC服务器端的函数
  
22.* 参数:
  
23.* $host 需要连接的主机
  
24.* $port 连接主机的端口
  
25.* $rpc_server XML-RPC服务器端文件
  
26.* $request 封装的XML请求信息
  
27.* 返回:连接成功成功返回由服务器端返回的XML信息,失败返回false
  
28.*/
  
29.function rpc_client_call($host, $port, $rpc_server, $request) {
  
30.
  $fp
= fsockopen($host, $port);
  
31.
  $query
="POST $rpc_server HTTP/1.0\nUser_Agent: XML-RPC Client\nHost: ".$host."\nContent-Type: text/xml\nContent-Length: ".strlen($request)."\n\n".$request."\n";
  
32.
  
if (!fputs($fp, $query, strlen($query))) {
  
33.
  $errstr
="Write error";
  
34.
  return
false;
  
35.
  }
  
36.
  $contents
='';
  37.
  
while (!feof($fp)){
  
38.
  $contents .
= fgets($fp);
  
39.
  }
  
40.
  fclose($fp);
  
41.
  return $contents;
  
42.}
  
43.?>

  server.php

  代码:

 

01.  
  
02./**
  
03.* 函数:提供给RPC客户端调用的函数
  
04.* 参数:
  
05.* $method 客户端需要调用的函数
  
06.* $params 客户端需要调用的函数的参数数组
  
07.* 返回:返回指定调用结果
  
08.*/
  
09.function rpc_server_extendedping($method, $params) {
  
10.
  $title
= $params[0];
  
11.
  $server
= $params[1];
  
12.
  $rss
= $params[2];
  
13.
  
//中间的判断,成功返回$XML_RPC_String
  
14.
  $XML_RPC_String
=array('flerror'=>false,'message'=>'Thanks for the ping.');
  15.
  return $XML_RPC_String;
  
16.}
  
17.function rpc_server_ping($method, $params) {
  
18.
  $title
= $params[0];
  
19.
  $server
= $params[1];
  
20.
  
//中间的判断,成功返回$XML_RPC_String
  
21.
  $XML_RPC_String
=array('flerror'=>false,'message'=>'Thanks for the ping.');
  22.
  return $XML_RPC_String;
  
23.}
  
24.//产生一个XML-RPC的服务器端
  
25.$xmlrpc_server = xmlrpc_server_create();
  
26.//注册一个服务器端调用的方法rpc_server,实际指向的是rpc_server_extendedping函数
  
27.xmlrpc_server_reGISter_method($xmlrpc_server, "weblogUpdates.extendedPing", "rpc_server_extendedping");
  
28.xmlrpc_server_register_method($xmlrpc_server, "weblogUpdates.Ping", "rpc_server_ping");
  
29.//接受客户端POST过来的XML数据
  
30.$request = $HTTP_RAW_POST_DATA;
  
31.//print_r($request);
  
32.//执行调用客户端的XML请求后获取执行结果
  
33.$xmlrpc_response = xmlrpc_server_call_method($xmlrpc_server, $request, null);
  
34.//把函数处理后的结果XML进行输出
  
35.header('Content-Type: text/xml');
  36.echo $xmlrpc_response;
  
37.//销毁XML-RPC服务器端资源
  
38.xmlrpc_server_destroy($xmlrpc_server);
  
39.?>

  类写的,有BUG

  代码:

 

 01.  
  
02.class Pings {
  
03.
  
public $xmlrpc_server;
  
04.
  
public $xmlrpc_response;
  
05.
  
public $methodName;
  
06.
  
publicfunction __construct() {
  
07.
  
//产生一个XML-RPC的服务器端
  
08.
  $this
->xmlrpc_server = xmlrpc_server_create ();
  
09.
  $this
->run ();
  
10.
  }
  
11.
  
12.
  
//注册一个服务器端调用的方法rpc_server,实际指向的是ping函数
  
13.
  
publicfunction rpc_server() {
  
14.
  $this
->methodName = !$this->methodName ? 'weblogUpdates.extendedPing':'weblogUpdates.Ping';
  15.
  xmlrpc_server_register_method ( $this
->xmlrpc_server, $this->methodName, array (__CLASS__, "ping"));
  
16.
  }
  
17.
  
/**
  
18.
  
* 函数:提供给RPC客户端调用的函数
  
19.
  
* 参数:
  
20.
  
* $method 客户端需要调用的函数
  
21.
  
* $params 客户端需要调用的函数的参数数组
  
22.
  
* 返回:返回指定调用结果
  
23.
  
*/
  
24.
  
publicfunction ping($method, $params) {
  
25.
  $this
->title = $params [0];
  
26.
  $this
->server = $params [1];
  
27.
  $this
->rss = $params [2];
  
28.
  $this
->tag = $params [3];
  
29.
  
//$a = $this->title ? $this->update():'';
  30.
  $
string=array ('flerror' => false, 'message' => 'Thanks for the ping.', 'legal' => "You agree that use of the blueidea.com ping service is governed by the Terms of Use found at www.blueidea.com." );
  31.
  return $
string;
  
32.
  }
  
33.
  
34.
  
publicfunction update(){
  
35.
  echo
'这里放更新的一些条件';
  36.
  }
  
37.
  
38.
  
publicfunction run() {
  
39.
  $this
->rpc_server ();
  
40.
  $request
= isset ( $GLOBALS ["HTTP_RAW_POST_DATA"] ) ? file_get_contents ( "php://input" ) : $GLOBALS ["HTTP_RAW_POST_DATA"];
  
41.
  $this
->xmlrpc_response = xmlrpc_server_call_method ( $this->xmlrpc_server, $request, null );
  
42.
  
//把函数处理后的结果XML进行输出
  
43.
  header (
'Content-Type: text/xml' );
  44.
  echo $this
->xmlrpc_response;
  
45.
  }
  
46.
  
47.
  
//销毁XML-RPC服务器端资源
  
48.
  
publicfunction __destruct() {
  
49.
  xmlrpc_server_destroy ( $this
->xmlrpc_server );
  
50.
  }
  
51.}
  
52.$Obj =new Pings ( );
  
53.?>

  WebService的最常用的两种方法算是写齐了。

你可能感兴趣的:(webservice)