PHP中使用XMLRPC

 

　　PHP中简单使用XMLRPC，服务器端和客户端都为PHP代码实现。

 

　　这里使用的XML-RPC完整包括client和server的XML-RPC实现。
　　客户端和服务器端分别由 xmlrpc_client 类和 xmlrpc_server 类实现，主要用于接收和发送XML-RPC报文。

客户端：

　　xmlrpcval 类用于将PHP变量编码为XML-RPC等价数据类型和向远程方法传递参数。相反的过程使用 xmlrpc_decode() 函数。

　　xmlrpcmsg 类通过传递给它一个参数表来创建XML-RPC报文。
　　xmlrpc_client 类发送使用 xmlrpcmsg 类创建的XML-RPC报文。

服务器端：

　　xmlrpc_server 类解析这些收到的报文（xmlrpcmsg 对象）为PHP变量。

　　然后被作为一个单独参数传递给用户函数，该函数必须返回一个 xmlrpcresp 对象，。

　　xmlrpc_server 类将其用于序列化并返回给客户端。

服务器端：xmlrpc_s.php

<?php
/*XMLRPC服务器（PHP版）*/

require "libphpxmlrpc/xmlrpc.inc";
require "libphpxmlrpc/xmlrpcs.inc";

function saySomething($msg) 
{
//从msg对象中解码出参数放入变量中
 $words = php_xmlrpc_decode($msg->getParam(0));

 //返回结果
 if(strlen($words) > 0) 
 {   
  return new xmlrpcresp( new xmlrpcval('Server say: '.$words, 'string') );//返回给客户的
 }
 else
 {    
   return new xmlrpcresp(0,$xmlrpcerruser + 100, "paras '".$words."' understand.");
 //出现错误返回给客户的，当然也可以不返回
 //如果有什么参数不对啊 系统会返回错误的
 //$xmlrpcerruser + 100 这个是返回客户自定义错误时候的错误代码
 //开发RPC程序的时候最好自己定义一个错误表客户端显示的错误编号会是100
 }
}

//建立服务器
$s = new xmlrpc_server(array('say' => array('function' => 'saySomething', //命令对应要调用的函数     
 'signature' => array(array('string','string')), //返回输入的数据类型,一个函数可以有几种输入和输出类型     
 'docstring' => 'This service echoes Hello+input stirng.')), //对该调用的说明    
 0 //此参数决定此时不立即开启服务   
 );

//设置参数
$s->response_charset_encoding = "UTF-8"; 

//开启服务
 $s->service();
?>

客户端：xmlrpc_c.php

<?php
//引入xmlrpc开发库
require('libphpxmlrpc/xmlrpc.inc');

//建立连接器
$client = new xmlrpc_client('/PHPWorkspace/xmlrpc_s.php', 'localhost', 80);

$client->request_charset_encoding = 'UTF-8';

//可以设置调试来查看详细HTTP请求信息 
if($_GET['debug']) $client->setDebug(true); 

//创建xmlrpcval对象，将PHP变量编码为XML-RPC需要的XML形式
$input = new xmlrpcval('Hello!', 'string');

//参数都要放入到数组中
$paras = array($input);

//创建XML-RPC报文
$msg = new xmlrpcmsg('say', $paras);


//用刚才建立的连接器发送请求
$rsp = $client->send($msg);

//处理服务器的返回值
if(0 == $rsp->faultcode()) 
{
    //解码
    $response = php_xmlrpc_decode($rsp->value());

    //显示结果
    #var_dump($response);
    echo $response;
} 
else
{
    //发生错误
    print 'Error: '.$rsp->faultcode().', '.$rsp->faultstring().'';
}
?>

其中需要引入xmlrpc开发库，不清楚的话可以参考本人前一篇博客，当中有提到。

在浏览器中打开客户端文件，效果如下图：