php webservice最常用的方法

文本Tag：PHP

　　【IT168 技术】企业级应用，主要是讲PHP5对Webservice的一些实现(以下的程序可以被Java，NET，C等正常调用)

　　国内用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.
　　public function __construct() {
　　07.
　　//产生一个XML-RPC的服务器端
　　08.
　　$this->xmlrpc_server = xmlrpc_server_create ();
　　09.
　　$this->run ();
　　10.
　　}
　　11.
　　12.
　　//注册一个服务器端调用的方法rpc_server，实际指向的是ping函数
　　13.
　　public function 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.
　　public function 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.
　　public function update(){
　　35.
　　echo '这里放更新的一些条件';
　　36.
　　}
　　37.
　　38.
　　public function 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.
　　public function __destruct() {
　　49.
　　xmlrpc_server_destroy ( $this->xmlrpc_server );
　　50.
　　}
　　51.}
　　52.$Obj = new Pings ( );
　　53.?>

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