You are here

function xmlrpc_server in Drupal 4

Same name and namespace in other branches
  1. 5 includes/xmlrpcs.inc \xmlrpc_server()
  2. 6 includes/xmlrpcs.inc \xmlrpc_server()
  3. 7 includes/xmlrpcs.inc \xmlrpc_server()

The main entry point for XML-RPC requests.

Parameters

$callbacks: Array of external XML-RPC method names with the callbacks they map to.

1 call to xmlrpc_server()
xmlrpc.php in ./xmlrpc.php

File

includes/xmlrpcs.inc, line 9

Code

function xmlrpc_server($callbacks) {
  $xmlrpc_server = new stdClass();

  // Define built-in XML-RPC method names
  $defaults = array(
    'system.multicall' => 'xmlrpc_server_multicall',
    array(
      'system.methodSignature',
      'xmlrpc_server_method_signature',
      array(
        'array',
        'string',
      ),
      'Returns an array describing the return type and required parameters of a method.',
    ),
    array(
      'system.getCapabilities',
      'xmlrpc_server_get_capabilities',
      array(
        'struct',
      ),
      'Returns a struct describing the XML-RPC specifications supported by this server.',
    ),
    array(
      'system.listMethods',
      'xmlrpc_server_list_methods',
      array(
        'array',
      ),
      'Returns an array of available methods on this server.',
    ),
    array(
      'system.methodHelp',
      'xmlrpc_server_method_help',
      array(
        'string',
        'string',
      ),
      'Returns a documentation string for the specified method.',
    ),
  );

  // We build an array of all method names by combining the built-ins
  // with those defined by modules implementing the _xmlrpc hook.
  // Built-in methods are overridable.
  foreach (array_merge($defaults, (array) $callbacks) as $key => $callback) {

    // we could check for is_array($callback)
    if (is_int($key)) {
      $method = $callback[0];
      $xmlrpc_server->callbacks[$method] = $callback[1];
      $xmlrpc_server->signatures[$method] = $callback[2];
      $xmlrpc_server->help[$method] = $callback[3];
    }
    else {
      $xmlrpc_server->callbacks[$key] = $callback;
      $xmlrpc_server->signatures[$key] = '';
      $xmlrpc_server->help[$key] = '';
    }
  }
  $data = file_get_contents('php://input');
  if (!$data) {
    die('XML-RPC server accepts POST requests only.');
  }
  $xmlrpc_server->message = xmlrpc_message($data);
  if (!xmlrpc_message_parse($xmlrpc_server->message)) {
    xmlrpc_server_error(-32700, t('Parse error. Request not well formed.'));
  }
  if ($xmlrpc_server->message->messagetype != 'methodCall') {
    xmlrpc_server_error(-32600, t('Server error. Invalid XML-RPC. Request must be a methodCall.'));
  }
  xmlrpc_server_set($xmlrpc_server);
  $result = xmlrpc_server_call($xmlrpc_server, $xmlrpc_server->message->methodname, $xmlrpc_server->message->params);
  if ($result->is_error) {
    xmlrpc_server_error($result);
  }

  // Encode the result
  $r = xmlrpc_value($result);

  // Create the XML
  $xml = '
<methodResponse>
  <params>
  <param>
    <value>' . xmlrpc_value_get_xml($r) . '</value>
  </param>
  </params>
</methodResponse>

';

  // Send it
  xmlrpc_server_output($xml);
}