XML-RPC
- Введение
- Установка и настройка
- Предопределенные константы
- XML-RPC Функции
- xmlrpc_decode_request — Декодирует XML в нативные типы PHP
- xmlrpc_decode — Декодирует XML в нативные типы PHP
- xmlrpc_encode_request — Генерирует XML для метода запроса
- xmlrpc_encode — Генерирует XML для PHP значения
- xmlrpc_get_type — Получает XML-RPC тип для значения PHP
- xmlrpc_is_fault — Определяет, является ли массив значений представлением ошибки XMLRPC
- xmlrpc_parse_method_descriptions — Декодирует XML в список описаний методов
- xmlrpc_server_add_introspection_data — Добавляет документацию самоанализа
- xmlrpc_server_call_method — Разбирает XML запросы и вызывающие методы
- xmlrpc_server_create — Создаёт XML-RPC сервер
- xmlrpc_server_destroy — Уничтожает серверные ресурсы
- xmlrpc_server_register_introspection_callback — Регистрирует функцию PHP для генерации документации
- xmlrpc_server_register_method — Регистрирует функцию PHP к методу ресурса, соответствующему method_name
- xmlrpc_set_type — Устанавливает тип XML-RPC, base64 или datetime для значения строки PHP
Коментарии
Here is a little wrapper class I just developed. It simply calls the methods you register with it.
<?php
class XMLRPCServer {
private $serverHandler;
private $externalFunctions;
public function __construct() {
$this->serverHandler = xmlrpc_server_create();
$this->externalFunctions = array();
}
public function registerMethod($externalName, $function, $parameterNames) {
if($function == null) $function = $externalName;
xmlrpc_server_register_method($this->serverHandler, $externalName, array(&$this, 'callMethod'));
$this->externalFunctions[$externalName] =
array('function' => $function,
'parameterNames' => $parameterNames);
}
public function callMethod($functionName, $parametersFromRequest) {
$function = $this->externalFunctions[$functionName]['function'];
$parameterNames = $this->externalFunctions[$functionName]['parameterNames'];
$parameters = array();
foreach($parameterNames as $parameterName) {
$parameters[] = $parametersFromRequest[0][$parameterName];
}
return call_user_func_array($function, $parameters);
}
public function computeAnswer() {
return xmlrpc_server_call_method($this->serverHandler, file_get_contents('php://input'), null);
}
}
// USAGE EXAMPLE HERE
$xmlRPCServer = new XMLRPCServer();
$someServer = new SomeXmlRPCServer($xmlRPCServer);
$answer = $xmlRPCServer->computeAnswer();
header('Content-Type: text/xml');
print($answer);
class SomeXmlRPCServer{
private $xmlRPCServer;
public function __construct($xmlRPCServer) {
$this->xmlRPCServer = $xmlRPCServer;
$this->xmlRPCServer->registerMethod(
'selectDatabase', // The name the XML-RPC Client calls
array(&$this, 'selectDatabaseInternal'), // Pointer to the method, can be a simple string if you have global functions
array('dbName', 'something') // Name of the parameters and their ordering
);
}
public function selectDatabaseInternal($dbName, $test) {
return 'dbName:.'.$dbName.'.test:'.$test;
}
}
?>