Same name and namespace in other branches
  1. 4.6.x includes/xmlrpc.inc \xmlrpc()
  2. 4.7.x includes/common.inc \xmlrpc()
  3. 5.x includes/common.inc \xmlrpc()
  4. 6.x includes/common.inc \xmlrpc()

Performs one or more XML-RPC request(s).

Usage example:

$result = xmlrpc('http://example.com/xmlrpc.php', array(
  'service.methodName' => array(
    $parameter,
    $second,
    $third,
  ),
));

Parameters

$url: An absolute URL of the XML-RPC endpoint.

$args: An associative array whose keys are the methods to call and whose values are the arguments to pass to the respective method. If multiple methods are specified, a system.multicall is performed.

$options: (optional) An array of options to pass along to drupal_http_request().

Return value

For one request: Either the return value of the method on success, or FALSE. If FALSE is returned, see xmlrpc_errno() and xmlrpc_error_msg(). For multiple requests: An array of results. Each result will either be the result returned by the method called, or an xmlrpc_error object if the call failed. See xmlrpc_error().

6 calls to xmlrpc()
XMLRPCBasicTestCase::testListMethods in modules/simpletest/tests/xmlrpc.test
Ensure that a basic XML-RPC call with no parameters works.
XMLRPCBasicTestCase::testMethodSignature in modules/simpletest/tests/xmlrpc.test
Ensure that system.methodSignature returns an array of signatures.
XMLRPCMessagesTestCase::testAlterListMethods in modules/simpletest/tests/xmlrpc.test
Ensure that hook_xmlrpc_alter() can hide even builtin methods.
XMLRPCMessagesTestCase::testMulticallLimit in modules/simpletest/tests/xmlrpc.test
Test limits on system.multicall that can prevent brute-force attacks.
XMLRPCMessagesTestCase::testSizedMessages in modules/simpletest/tests/xmlrpc.test
Make sure that XML-RPC can transfer large messages.

... See full list

File

includes/common.inc, line 8510
Common functions that many Drupal modules will need to reference.

Code

function xmlrpc($url, $args, $options = array()) {
  require_once DRUPAL_ROOT . '/includes/xmlrpc.inc';
  return _xmlrpc($url, $args, $options);
}