497 lines
15 KiB
PHP
497 lines
15 KiB
PHP
<?php
|
|
// $Id$
|
|
|
|
/**
|
|
* @file
|
|
* Drupal XML-RPC library. Based on the IXR - The Incutio XML-RPC Library - (c) Incutio Ltd 2002-2005
|
|
* Version 1.7 (beta) - Simon Willison, 23rd May 2005
|
|
* Site: http://scripts.incutio.com/xmlrpc/
|
|
* Manual: http://scripts.incutio.com/xmlrpc/manual.php
|
|
* This version is made available under the GNU GPL License
|
|
*/
|
|
|
|
/**
|
|
* Recursively turn a data structure into objects with 'data' and 'type' attributes.
|
|
*
|
|
* @param $data
|
|
* The data structure.
|
|
* @param $type
|
|
* Optional type assign to $data.
|
|
* @return
|
|
* Object.
|
|
*/
|
|
function xmlrpc_value($data, $type = FALSE) {
|
|
$xmlrpc_value = new stdClass();
|
|
$xmlrpc_value->data = $data;
|
|
if (!$type) {
|
|
$type = xmlrpc_value_calculate_type($xmlrpc_value);
|
|
}
|
|
$xmlrpc_value->type = $type;
|
|
if ($type == 'struct') {
|
|
// Turn all the values in the array into new xmlrpc_values
|
|
foreach ($xmlrpc_value->data as $key => $value) {
|
|
$xmlrpc_value->data[$key] = xmlrpc_value($value);
|
|
}
|
|
}
|
|
if ($type == 'array') {
|
|
for ($i = 0, $j = count($xmlrpc_value->data); $i < $j; $i++) {
|
|
$xmlrpc_value->data[$i] = xmlrpc_value($xmlrpc_value->data[$i]);
|
|
}
|
|
}
|
|
return $xmlrpc_value;
|
|
}
|
|
|
|
/**
|
|
* Map PHP type to XML-RPC type.
|
|
*
|
|
* @param $xmlrpc_value
|
|
* Variable whose type should be mapped.
|
|
* @return
|
|
* XML-RPC type as string.
|
|
* @see
|
|
* http://www.xmlrpc.com/spec#scalars
|
|
*/
|
|
function xmlrpc_value_calculate_type(&$xmlrpc_value) {
|
|
// http://www.php.net/gettype: Never use gettype() to test for a certain type [...] Instead, use the is_* functions.
|
|
if (is_bool($xmlrpc_value->data)) {
|
|
return 'boolean';
|
|
}
|
|
if (is_double($xmlrpc_value->data)) {
|
|
return 'double';
|
|
}
|
|
if (is_int($xmlrpc_value->data)) {
|
|
return 'int';
|
|
}
|
|
if (is_array($xmlrpc_value->data)) {
|
|
// empty or integer-indexed arrays are 'array', string-indexed arrays 'struct'
|
|
return empty($xmlrpc_value->data) || range(0, count($xmlrpc_value->data) - 1) === array_keys($xmlrpc_value->data) ? 'array' : 'struct';
|
|
}
|
|
if (is_object($xmlrpc_value->data)) {
|
|
if (isset($xmlrpc_value->data->is_date)) {
|
|
return 'date';
|
|
}
|
|
if (isset($xmlrpc_value->data->is_base64)) {
|
|
return 'base64';
|
|
}
|
|
$xmlrpc_value->data = get_object_vars($xmlrpc_value->data);
|
|
return 'struct';
|
|
}
|
|
// default
|
|
return 'string';
|
|
}
|
|
|
|
/**
|
|
* Generate XML representing the given value.
|
|
*
|
|
* @param $xmlrpc_value
|
|
* @return
|
|
* XML representation of value.
|
|
*/
|
|
function xmlrpc_value_get_xml($xmlrpc_value) {
|
|
switch ($xmlrpc_value->type) {
|
|
case 'boolean':
|
|
return '<boolean>' . (($xmlrpc_value->data) ? '1' : '0') . '</boolean>';
|
|
break;
|
|
case 'int':
|
|
return '<int>' . $xmlrpc_value->data . '</int>';
|
|
break;
|
|
case 'double':
|
|
return '<double>' . $xmlrpc_value->data . '</double>';
|
|
break;
|
|
case 'string':
|
|
// Note: we don't escape apostrophes because of the many blogging clients
|
|
// that don't support numerical entities (and XML in general) properly.
|
|
return '<string>' . htmlspecialchars($xmlrpc_value->data) . '</string>';
|
|
break;
|
|
case 'array':
|
|
$return = '<array><data>' . "\n";
|
|
foreach ($xmlrpc_value->data as $item) {
|
|
$return .= ' <value>' . xmlrpc_value_get_xml($item) . "</value>\n";
|
|
}
|
|
$return .= '</data></array>';
|
|
return $return;
|
|
break;
|
|
case 'struct':
|
|
$return = '<struct>' . "\n";
|
|
foreach ($xmlrpc_value->data as $name => $value) {
|
|
$return .= " <member><name>" . check_plain($name) . "</name><value>";
|
|
$return .= xmlrpc_value_get_xml($value) . "</value></member>\n";
|
|
}
|
|
$return .= '</struct>';
|
|
return $return;
|
|
break;
|
|
case 'date':
|
|
return xmlrpc_date_get_xml($xmlrpc_value->data);
|
|
break;
|
|
case 'base64':
|
|
return xmlrpc_base64_get_xml($xmlrpc_value->data);
|
|
break;
|
|
}
|
|
return FALSE;
|
|
}
|
|
|
|
/**
|
|
* Construct an object representing an XML-RPC message.
|
|
*
|
|
* @param $message
|
|
* String containing XML as defined at http://www.xmlrpc.com/spec
|
|
* @return
|
|
* Object
|
|
*/
|
|
function xmlrpc_message($message) {
|
|
$xmlrpc_message = new stdClass();
|
|
$xmlrpc_message->array_structs = array(); // The stack used to keep track of the current array/struct
|
|
$xmlrpc_message->array_structs_types = array(); // The stack used to keep track of if things are structs or array
|
|
$xmlrpc_message->current_struct_name = array(); // A stack as well
|
|
$xmlrpc_message->message = $message;
|
|
return $xmlrpc_message;
|
|
}
|
|
|
|
/**
|
|
* Parse an XML-RPC message. If parsing fails, the faultCode and faultString
|
|
* will be added to the message object.
|
|
*
|
|
* @param $xmlrpc_message
|
|
* Object generated by xmlrpc_message()
|
|
* @return
|
|
* TRUE if parsing succeeded; FALSE otherwise
|
|
*/
|
|
function xmlrpc_message_parse(&$xmlrpc_message) {
|
|
// First remove the XML declaration
|
|
$xmlrpc_message->message = preg_replace('/<\?xml(.*)?\?' . '>/', '', $xmlrpc_message->message);
|
|
if (trim($xmlrpc_message->message) == '') {
|
|
return FALSE;
|
|
}
|
|
$xmlrpc_message->_parser = xml_parser_create();
|
|
// Set XML parser to take the case of tags into account.
|
|
xml_parser_set_option($xmlrpc_message->_parser, XML_OPTION_CASE_FOLDING, FALSE);
|
|
// Set XML parser callback functions
|
|
xml_set_element_handler($xmlrpc_message->_parser, 'xmlrpc_message_tag_open', 'xmlrpc_message_tag_close');
|
|
xml_set_character_data_handler($xmlrpc_message->_parser, 'xmlrpc_message_cdata');
|
|
xmlrpc_message_set($xmlrpc_message);
|
|
if (!xml_parse($xmlrpc_message->_parser, $xmlrpc_message->message)) {
|
|
return FALSE;
|
|
}
|
|
xml_parser_free($xmlrpc_message->_parser);
|
|
// Grab the error messages, if any
|
|
$xmlrpc_message = xmlrpc_message_get();
|
|
if ($xmlrpc_message->messagetype == 'fault') {
|
|
$xmlrpc_message->fault_code = $xmlrpc_message->params[0]['faultCode'];
|
|
$xmlrpc_message->fault_string = $xmlrpc_message->params[0]['faultString'];
|
|
}
|
|
return TRUE;
|
|
}
|
|
|
|
/**
|
|
* Store a copy of the $xmlrpc_message object temporarily.
|
|
*
|
|
* @param $value
|
|
* Object
|
|
* @return
|
|
* The most recently stored $xmlrpc_message
|
|
*/
|
|
function xmlrpc_message_set($value = NULL) {
|
|
static $xmlrpc_message;
|
|
if ($value) {
|
|
$xmlrpc_message = $value;
|
|
}
|
|
return $xmlrpc_message;
|
|
}
|
|
|
|
function xmlrpc_message_get() {
|
|
return xmlrpc_message_set();
|
|
}
|
|
|
|
function xmlrpc_message_tag_open($parser, $tag, $attr) {
|
|
$xmlrpc_message = xmlrpc_message_get();
|
|
$xmlrpc_message->current_tag_contents = '';
|
|
$xmlrpc_message->last_open = $tag;
|
|
switch ($tag) {
|
|
case 'methodCall':
|
|
case 'methodResponse':
|
|
case 'fault':
|
|
$xmlrpc_message->messagetype = $tag;
|
|
break;
|
|
// Deal with stacks of arrays and structs
|
|
case 'data':
|
|
$xmlrpc_message->array_structs_types[] = 'array';
|
|
$xmlrpc_message->array_structs[] = array();
|
|
break;
|
|
case 'struct':
|
|
$xmlrpc_message->array_structs_types[] = 'struct';
|
|
$xmlrpc_message->array_structs[] = array();
|
|
break;
|
|
}
|
|
xmlrpc_message_set($xmlrpc_message);
|
|
}
|
|
|
|
function xmlrpc_message_cdata($parser, $cdata) {
|
|
$xmlrpc_message = xmlrpc_message_get();
|
|
$xmlrpc_message->current_tag_contents .= $cdata;
|
|
xmlrpc_message_set($xmlrpc_message);
|
|
}
|
|
|
|
function xmlrpc_message_tag_close($parser, $tag) {
|
|
$xmlrpc_message = xmlrpc_message_get();
|
|
$value_flag = FALSE;
|
|
switch ($tag) {
|
|
case 'int':
|
|
case 'i4':
|
|
$value = (int)trim($xmlrpc_message->current_tag_contents);
|
|
$value_flag = TRUE;
|
|
break;
|
|
case 'double':
|
|
$value = (double)trim($xmlrpc_message->current_tag_contents);
|
|
$value_flag = TRUE;
|
|
break;
|
|
case 'string':
|
|
$value = $xmlrpc_message->current_tag_contents;
|
|
$value_flag = TRUE;
|
|
break;
|
|
case 'dateTime.iso8601':
|
|
$value = xmlrpc_date(trim($xmlrpc_message->current_tag_contents));
|
|
// $value = $iso->getTimestamp();
|
|
$value_flag = TRUE;
|
|
break;
|
|
case 'value':
|
|
// If no type is indicated, the type is string
|
|
// We take special care for empty values
|
|
if (trim($xmlrpc_message->current_tag_contents) != '' || (isset($xmlrpc_message->last_open) && ($xmlrpc_message->last_open == 'value'))) {
|
|
$value = (string)$xmlrpc_message->current_tag_contents;
|
|
$value_flag = TRUE;
|
|
}
|
|
unset($xmlrpc_message->last_open);
|
|
break;
|
|
case 'boolean':
|
|
$value = (boolean)trim($xmlrpc_message->current_tag_contents);
|
|
$value_flag = TRUE;
|
|
break;
|
|
case 'base64':
|
|
$value = base64_decode(trim($xmlrpc_message->current_tag_contents));
|
|
$value_flag = TRUE;
|
|
break;
|
|
// Deal with stacks of arrays and structs
|
|
case 'data':
|
|
case 'struct':
|
|
$value = array_pop($xmlrpc_message->array_structs );
|
|
array_pop($xmlrpc_message->array_structs_types);
|
|
$value_flag = TRUE;
|
|
break;
|
|
case 'member':
|
|
array_pop($xmlrpc_message->current_struct_name);
|
|
break;
|
|
case 'name':
|
|
$xmlrpc_message->current_struct_name[] = trim($xmlrpc_message->current_tag_contents);
|
|
break;
|
|
case 'methodName':
|
|
$xmlrpc_message->methodname = trim($xmlrpc_message->current_tag_contents);
|
|
break;
|
|
}
|
|
if ($value_flag) {
|
|
if (count($xmlrpc_message->array_structs ) > 0) {
|
|
// Add value to struct or array
|
|
if ($xmlrpc_message->array_structs_types[count($xmlrpc_message->array_structs_types)-1] == 'struct') {
|
|
// Add to struct
|
|
$xmlrpc_message->array_structs [count($xmlrpc_message->array_structs )-1][$xmlrpc_message->current_struct_name[count($xmlrpc_message->current_struct_name)-1]] = $value;
|
|
}
|
|
else {
|
|
// Add to array
|
|
$xmlrpc_message->array_structs [count($xmlrpc_message->array_structs )-1][] = $value;
|
|
}
|
|
}
|
|
else {
|
|
// Just add as a parameter
|
|
$xmlrpc_message->params[] = $value;
|
|
}
|
|
}
|
|
if (!in_array($tag, array("data", "struct", "member"))) {
|
|
$xmlrpc_message->current_tag_contents = '';
|
|
}
|
|
xmlrpc_message_set($xmlrpc_message);
|
|
}
|
|
|
|
/**
|
|
* Construct an object representing an XML-RPC request
|
|
*
|
|
* @param $method
|
|
* The name of the method to be called
|
|
* @param $args
|
|
* An array of parameters to send with the method.
|
|
* @return
|
|
* Object
|
|
*/
|
|
function xmlrpc_request($method, $args) {
|
|
$xmlrpc_request = new stdClass();
|
|
$xmlrpc_request->method = $method;
|
|
$xmlrpc_request->args = $args;
|
|
$xmlrpc_request->xml = <<<EOD
|
|
<?xml version="1.0"?>
|
|
<methodCall>
|
|
<methodName>{$xmlrpc_request->method}</methodName>
|
|
<params>
|
|
|
|
EOD;
|
|
foreach ($xmlrpc_request->args as $arg) {
|
|
$xmlrpc_request->xml .= '<param><value>';
|
|
$v = xmlrpc_value($arg);
|
|
$xmlrpc_request->xml .= xmlrpc_value_get_xml($v);
|
|
$xmlrpc_request->xml .= "</value></param>\n";
|
|
}
|
|
$xmlrpc_request->xml .= '</params></methodCall>';
|
|
return $xmlrpc_request;
|
|
}
|
|
|
|
|
|
function xmlrpc_error($code = NULL, $message = NULL) {
|
|
static $xmlrpc_error;
|
|
if (isset($code)) {
|
|
$xmlrpc_error = new stdClass();
|
|
$xmlrpc_error->is_error = TRUE;
|
|
$xmlrpc_error->code = $code;
|
|
$xmlrpc_error->message = $message;
|
|
}
|
|
return $xmlrpc_error;
|
|
}
|
|
|
|
function xmlrpc_error_get_xml($xmlrpc_error) {
|
|
return <<<EOD
|
|
<methodResponse>
|
|
<fault>
|
|
<value>
|
|
<struct>
|
|
<member>
|
|
<name>faultCode</name>
|
|
<value><int>{$xmlrpc_error->code}</int></value>
|
|
</member>
|
|
<member>
|
|
<name>faultString</name>
|
|
<value><string>{$xmlrpc_error->message}</string></value>
|
|
</member>
|
|
</struct>
|
|
</value>
|
|
</fault>
|
|
</methodResponse>
|
|
|
|
EOD;
|
|
}
|
|
|
|
function xmlrpc_date($time) {
|
|
$xmlrpc_date = new stdClass();
|
|
$xmlrpc_date->is_date = TRUE;
|
|
// $time can be a PHP timestamp or an ISO one
|
|
if (is_numeric($time)) {
|
|
$xmlrpc_date->year = gmdate('Y', $time);
|
|
$xmlrpc_date->month = gmdate('m', $time);
|
|
$xmlrpc_date->day = gmdate('d', $time);
|
|
$xmlrpc_date->hour = gmdate('H', $time);
|
|
$xmlrpc_date->minute = gmdate('i', $time);
|
|
$xmlrpc_date->second = gmdate('s', $time);
|
|
$xmlrpc_date->iso8601 = gmdate('Ymd\TH:i:s', $time);
|
|
}
|
|
else {
|
|
$xmlrpc_date->iso8601 = $time;
|
|
$time = str_replace(array('-', ':'), '', $time);
|
|
$xmlrpc_date->year = substr($time, 0, 4);
|
|
$xmlrpc_date->month = substr($time, 4, 2);
|
|
$xmlrpc_date->day = substr($time, 6, 2);
|
|
$xmlrpc_date->hour = substr($time, 9, 2);
|
|
$xmlrpc_date->minute = substr($time, 11, 2);
|
|
$xmlrpc_date->second = substr($time, 13, 2);
|
|
}
|
|
return $xmlrpc_date;
|
|
}
|
|
|
|
function xmlrpc_date_get_xml($xmlrpc_date) {
|
|
return '<dateTime.iso8601>' . $xmlrpc_date->year . $xmlrpc_date->month . $xmlrpc_date->day . 'T' . $xmlrpc_date->hour . ':' . $xmlrpc_date->minute . ':' . $xmlrpc_date->second . '</dateTime.iso8601>';
|
|
}
|
|
|
|
function xmlrpc_base64($data) {
|
|
$xmlrpc_base64 = new stdClass();
|
|
$xmlrpc_base64->is_base64 = TRUE;
|
|
$xmlrpc_base64->data = $data;
|
|
return $xmlrpc_base64;
|
|
}
|
|
|
|
function xmlrpc_base64_get_xml($xmlrpc_base64) {
|
|
return '<base64>' . base64_encode($xmlrpc_base64->data) . '</base64>';
|
|
}
|
|
|
|
/**
|
|
* Performs one or more XML-RPC request(s).
|
|
*
|
|
* @param $url
|
|
* An absolute URL of the XML-RPC endpoint.
|
|
* Example:
|
|
* http://www.example.com/xmlrpc.php
|
|
* @param ...
|
|
* For one request:
|
|
* The method name followed by a variable number of arguments to the method.
|
|
* For multiple requests (system.multicall):
|
|
* An array of call arrays. Each call array follows the pattern of the single
|
|
* request: method name followed by the arguments to the method.
|
|
* @return
|
|
* 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().
|
|
*/
|
|
function xmlrpc() {
|
|
$args = func_get_args();
|
|
$url = array_shift($args);
|
|
if (is_array($args[0])) {
|
|
$method = 'system.multicall';
|
|
$multicall_args = array();
|
|
foreach ($args[0] as $call) {
|
|
$multicall_args[] = array('methodName' => array_shift($call), 'params' => $call);
|
|
}
|
|
$args = array($multicall_args);
|
|
}
|
|
else {
|
|
$method = array_shift($args);
|
|
}
|
|
$xmlrpc_request = xmlrpc_request($method, $args);
|
|
$options = array(
|
|
'headers' => array('Content-Type' => 'text/xml'),
|
|
'method' => 'POST',
|
|
'data' => $xmlrpc_request->xml,
|
|
);
|
|
$result = drupal_http_request($url, $options);
|
|
if ($result->code != 200) {
|
|
xmlrpc_error($result->code, $result->error);
|
|
return FALSE;
|
|
}
|
|
$message = xmlrpc_message($result->data);
|
|
// Now parse what we've got back
|
|
if (!xmlrpc_message_parse($message)) {
|
|
// XML error
|
|
xmlrpc_error(-32700, t('Parse error. Not well formed'));
|
|
return FALSE;
|
|
}
|
|
// Is the message a fault?
|
|
if ($message->messagetype == 'fault') {
|
|
xmlrpc_error($message->fault_code, $message->fault_string);
|
|
return FALSE;
|
|
}
|
|
// Message must be OK
|
|
return $message->params[0];
|
|
}
|
|
|
|
/**
|
|
* Returns the last XML-RPC client error number
|
|
*/
|
|
function xmlrpc_errno() {
|
|
$error = xmlrpc_error();
|
|
return ($error != NULL ? $error->code : NULL);
|
|
}
|
|
|
|
/**
|
|
* Returns the last XML-RPC client error message
|
|
*/
|
|
function xmlrpc_error_msg() {
|
|
$error = xmlrpc_error();
|
|
return ($error != NULL ? $error->message : NULL);
|
|
}
|