3 * XMLRPC server acting as proxy for requests to other servers
4 * (useful e.g. for ajax-originated calls that can only connect back to
5 * the originating server)
8 * @author Gaetano Giunta
9 * @copyright (C) 2006-2009 G. Giunta
10 * @license code licensed under the BSD License: http://phpxmlrpc.sourceforge.net/license.txt
13 include("xmlrpc.inc");
14 include("xmlrpcs.inc");
17 * Forward an xmlrpc request to another server, and return to client the response received.
18 * @param xmlrpcmsg $m (see method docs below for a description of the expected parameters)
21 function forward_request($m)
25 $url = php_xmlrpc_decode($m->getParam(0));
26 $c = new xmlrpc_client($url);
27 if ($m->getNumParams() > 3)
29 // we have to set some options onto the client.
30 // Note that if we do not untaint the received values, warnings might be generated...
31 $options = php_xmlrpc_decode($m->getParam(3));
32 foreach($options as $key => $val)
40 case 'RequestCompression':
41 $c->setRequestCompression($val);
44 $c->setSSLVerifyHost($val);
47 $c->setSSLVerifyPeer($val);
50 $timeout = (integer) $val;
56 // build call for remote server
57 /// @todo find a weay to forward client info (such as IP) to server, either
58 /// - as xml comments in the payload, or
59 /// - using std http header conventions, such as X-forwarded-for...
60 $method = php_xmlrpc_decode($m->getParam(1));
61 $pars = $m->getParam(2);
62 $m = new xmlrpcmsg($method);
63 for ($i = 0; $i < $pars->arraySize(); $i++)
65 $m->addParam($pars->arraymem($i));
68 // add debug info into response we give back to caller
69 xmlrpc_debugmsg("Sending to server $url the payload: ".$m->serialize());
70 return $c->send($m, $timeout);
74 $server = new xmlrpc_server(
76 'xmlrpcproxy.call' => array(
77 'function' => 'forward_request',
79 array('mixed', 'string', 'string', 'array'),
80 array('mixed', 'string', 'string', 'array', 'stuct'),
82 'docstring' => 'forwards xmlrpc calls to remote servers. Returns remote method\'s response. Accepts params: remote server url (might include basic auth credentials), method name, array of params, and (optionally) a struct containing call options'