Die im Internet verfügbare XML-RPC-Bibliothek ist sehr nützlich für die Entwicklung kleiner externer Kommunikationsschnittstellen. Speichern Sie diesen Code als xml-rpc.inc.php
<?php
/*
Die im Internet verfügbare XML-RPC-Bibliothek ist sehr nützlich für die Entwicklung kleiner externer Kommunikationsschnittstellen.
*/
Funktion & XML_serialize($data, $level = 0, $prior_key = NULL){
#nimmt einen Hash an, Schlüssel sind die Variablennamen
$xml_serialized_string = "";
while(list($key, $value) = every($data)){
$inline = false;
$numeric_array = false;
$attributes = "";
#echo „Mein aktueller Schlüssel ist ‚$key‘, aufgerufen mit dem vorherigen Schlüssel ‚$prior_key‘<br>“;
if(!strstr($key, " attr")){ #if es ist kein Attribut
if(array_key_exists("$key attr", $data)){
while(list($attr_name, $attr_value) = every($data["$key attr"])){
#echo „Attribut $attribute_name mit Wert $attribute_value<br> gefunden“;
$attr_value = &htmlspecialchars($attr_value, ENT_QUOTES);
$attributes .= " $attr_name="$attr_value"";
}
}
if(is_numeric($key)){
#echo „Mein aktueller Schlüssel ($key) ist numerisch. Mein übergeordneter Schlüssel ist ‚$prior_key‘<br>“;
$key = $prior_key;
}anders{
#Sie können keine Zifferntasten auf zwei Ebenen hintereinander haben, also ist das in Ordnung
#echo „Überprüft, ob in den Daten ein numerischer Schlüssel vorhanden ist.“;
if(is_array($value) and array_key_exists(0, $value)){
# echo "Das tut es! Ich rufe mich selbst als Ergebnis eines numerischen Arrays auf.<br>";
$numeric_array = true;
$xml_serialized_string .= XML_serialize($value, $level, $key);
}
#echo "<br>";
}
if(!$numeric_array){
$xml_serialized_string .= str_repeat("t", $level) "<$key$attributes>";
if(is_array($value)){
$xml_serialized_string .= "rn" XML_serialize($value, $level+1);
}anders{
$inline = true;
$xml_serialized_string .= htmlspecialchars($value);
}
$xml_serialized_string .= (!$inline ? str_repeat("t", $level) : "") .
}
}anders{
#echo „Attributdatensatz für Schlüssel $key<bR> wird übersprungen“;
}
}
if($level == 0){
$xml_serialized_string = "<?xml version="1.0" ?>rn" $xml_serialized_string;
return $xml_serialized_string;
}anders{
return $xml_serialized_string;
}
}
Klasse XML {
var $parser; #ein Verweis auf den XML-Parser
var $document; #die gesamte bisher aufgebaute XML-Struktur
var $current; #ein Zeiger auf das aktuelle Element – was ist das?
var $parent; #ein Zeiger auf das aktuelle übergeordnete Element – das übergeordnete Element ist ein Array
var $parents; #ein Array des aktuellsten übergeordneten Elements auf jeder Ebene
var $last_opened_tag;
Funktion XML($data=null){
$this->parser = xml_parser_create();
xml_parser_set_option ($this->parser, XML_OPTION_CASE_FOLDING, 0);
xml_set_object($this->parser, $this);
xml_set_element_handler($this->parser, "open", "close");
xml_set_character_data_handler($this->parser, "data");
# register_shutdown_function(array($this, 'destruct'));
}
Funktion destruct(){
xml_parser_free($this->parser);
}
Funktion parse($data){
$this->document = array();
$this->parent = $this->document;
$this->parents = array();
$this->last_opened_tag = NULL;
xml_parse($this->parser, $data);
return $this->document;
}
Funktion open($parser, $tag, $attributes){
#echo "Tag $tag<br>n wird geöffnet";
$this->data = "";
$this->last_opened_tag = $tag; #tag ist eine Zeichenfolge
if(array_key_exists($tag, $this->parent)){
#echo „Es gibt bereits eine Instanz von ‚$tag‘ auf der aktuellen Ebene ($level)<br>n“;
if(is_array($this->parent[$tag]) and array_key_exists(0, $this->parent[$tag])){ #wenn die Schlüssel numerisch sind
#muss sicherstellen, dass sie numerisch sind (Attribute berücksichtigen)
$key = count_numeric_items($this->parent[$tag]);
#echo „Es gibt $key-Instanzen: Die Schlüssel sind numerisch.<br>n“;
}anders{
#echo „Es gibt nur eine Instanz. Alles wird verschoben<br>n“;
$temp = $this->parent[$tag];
unset($this->parent[$tag]);
$this->parent[$tag][0] = $temp;
if(array_key_exists("$tag attr", $this->parent)){
#verschieben Sie auch die Attribute, falls vorhanden
$temp = $this->parent["$tag attr"];
unset($this->parent["$tag attr"]);
$this->parent[$tag]["0 attr"] = $temp;
}
$key = 1;
}
$this->parent = $this->parent[$tag];
}anders{
$key = $tag;
}
if($attributes){
$this->parent["$key attr"] = $attributes;
}
$this->parent[$key] = array();
$this->parent = $this->parent[$key];
array_unshift($this->parents, $this->parent);
}
Funktionsdaten($parser, $data){
#echo "Daten sind '", htmlspecialchars($data), "'<br>n";
if($this->last_opened_tag != NULL){
$this->data .= $data;
}
}
Funktion close($parser, $tag){
#echo "Tag $tag<br>n schließen";
if($this->last_opened_tag == $tag){
$this->parent = $this->data;
$this->last_opened_tag = NULL;
}
array_shift($this->parents);
$this->parent = $this->parents[0];
}
}
Funktion & XML_unserialize($xml){
$xml_parser = new XML();
$data = $xml_parser->parse($xml);
$xml_parser->destruct();
$data zurückgeben;
}
Funktion & XMLRPC_parse($request){
if(definiert('XMLRPC_DEBUG') und XMLRPC_DEBUG){
XMLRPC_debug('XMLRPC_parse', "<p>Folgende Rohanfrage erhalten:</p>" . XMLRPC_show($request, 'print_r', true));
}
$data = &XML_unserialize($request);
if(definiert('XMLRPC_DEBUG') und XMLRPC_DEBUG){
XMLRPC_debug('XMLRPC_parse', "<p>Die folgende analysierte Anfrage wird zurückgegeben:</p>" . XMLRPC_show($data, 'print_r', true));
}
$data zurückgeben;
}
Funktion & XMLRPC_prepare($data, $type = NULL){
if(is_array($data)){
$num_elements = count($data);
if((array_key_exists(0, $data) or !$num_elements) and $type != 'struct'){ #es ist ein Array
if(!$num_elements){ #wenn das Array leer ist
$returnvalue = array('array' => array('data' => NULL));
}anders{
$returnvalue['array']['data']['value'] = array();
$temp = $returnvalue['array']['data']['value'];
$count = count_numeric_items($data);
for($n=0; $n<$count; $n++){
$type = NULL;
if(array_key_exists("$n type", $data)){
$type = $data["$n type"];
}
$temp[$n] = XMLRPC_prepare($data[$n], $type);
}
}
}else{ #es ist eine Struktur
if(!$num_elements){ #wenn die Struktur leer ist
$returnvalue = array('struct' => NULL);
}anders{
$returnvalue['struct']['member'] = array();
$temp = $returnvalue['struct']['member'];
while(list($key, $value) = every($data)){
if(substr($key, -5) != ' type'){ #if es ist kein Typspezifizierer
$type = NULL;
if(array_key_exists("$key type", $data)){
$type = $data["$key type"];
}
$temp[] = array('name' => $key, 'value' => XMLRPC_prepare($value, $type));
}
}
}
}
}else{ #es ist ein Skalar
if(!$type){
if(is_int($data)){
$returnvalue['int'] = $data;
return $returnvalue;
}elseif(is_float($data)){
$returnvalue['double'] = $data;
return $returnvalue;
}elseif(is_bool($data)){
$returnvalue['boolean'] = ($data ? 1 : 0);
return $returnvalue;
}elseif(preg_match('/^d{8}Td{2}:d{2}:d{2}$/', $data, $matches)){ #es ist ein Datum
$returnvalue['dateTime.iso8601'] = $data;
return $returnvalue;
}elseif(is_string($data)){
$returnvalue['string'] = htmlspecialchars($data);
return $returnvalue;
}
}anders{
$returnvalue[$type] = htmlspecialchars($data);
}
}
return $returnvalue;
}
Funktion & XMLRPC_adjustValue($current_node){
if(is_array($current_node)){
if(isset($current_node['array'])){
if(!is_array($current_node['array']['data'])){
#Wenn keine Elemente vorhanden sind, wird ein leeres Array zurückgegeben
return array();
}anders{
#echo "Array entfernen -> Daten -> Wert<br>n";
$temp = $current_node['array']['data']['value'];
if(is_array($temp) and array_key_exists(0, $temp)){
$count = count($temp);
for($n=0;$n<$count;$n++){
$temp2[$n] = &XMLRPC_adjustValue($temp[$n]);
}
$temp = $temp2;
}anders{
$temp2 = &XMLRPC_adjustValue($temp);
$temp = array($temp2);
#Ich mache die temporäre Aufgabe, weil sie das Kopieren vermeidet,
# da ich eine Referenz in das Array einfügen kann
Das Referenzmodell von #PHP ist etwas albern und ich kann nicht einfach sagen:
# $temp = array(&XMLRPC_adjustValue($temp));
}
}
}elseif(isset($current_node['struct'])){
if(!is_array($current_node['struct'])){
#Wenn keine Mitglieder vorhanden sind, wird ein leeres Array zurückgegeben
return array();
}anders{
#echo "Struktur -> Mitglied entfernen<br>n";
$temp = $current_node['struct']['member'];
if(is_array($temp) and array_key_exists(0, $temp)){
$count = count($temp);
for($n=0;$n<$count;$n++){
#echo „Übergabe des Namens {$temp[$n][name]}. Wert ist: „ show($temp[$n][value], var_dump, true) „<br>n“;
$temp2[$temp[$n]['name']] = &XMLRPC_adjustValue($temp[$n]['value']);
#echo "adjustValue(): Nach der Zuweisung ist der Wert " . show($temp2[$temp[$n]['name']], var_dump, true) "<br>n";
}
}anders{
#echo "Übergabe des Namens $temp[name]<br>n";
$temp2[$temp['name']] = &XMLRPC_adjustValue($temp['value']);
}
$temp = $temp2;
}
}anders{
$types = array('string', 'int', 'i4', 'double', 'dateTime.iso8601', 'base64', 'boolean');
$fell_through = true;
foreach($types as $type){
if(array_key_exists($type, $current_node)){
#echo "'$type' entfernen<br>n";
$temp = $current_node[$type];
#echo "adjustValue(): Der aktuelle Knoten wird mit einem Typ von $type<br>n";
$fell_through = false;
brechen;
}
}
if($fell_through){
$type = 'string';
#echo „Durchgefallen! Typ ist $type<br>n“;
}
switch ($type){
case 'int': case 'i4': $temp = (int)$temp;
case 'string': $temp = (string)$temp;
case 'double': $temp = (double)$temp;
case 'boolean': $temp = (bool)$temp;
}
}
}anders{
$temp = (string)$current_node;
}
return $temp;
}
Funktion XMLRPC_getParams($request){
if(!is_array($request['methodCall']['params'])){
#Wenn keine Parameter vorhanden sind, wird ein leeres Array zurückgegeben
return array();
}anders{
#echo "methodCall loswerden -> params -> param<br>n";
$temp = $request['methodCall']['params']['param'];
if(is_array($temp) and array_key_exists(0, $temp)){
$count = count($temp);
for($n = 0; $n < $count; $n++){
#echo „Parameter $n<br>serialisieren“;
$temp2[$n] = &XMLRPC_adjustValue($temp[$n]['value']);
}
}anders{
$temp2[0] = &XMLRPC_adjustValue($temp['value']);
}
$temp = $temp2;
return $temp;
}
}
Funktion XMLRPC_getMethodName($methodCall){
#gibt den Methodennamen zurück
return $methodCall['methodCall']['methodName'];
}
Funktion XMLRPC_request($site, $location, $methodName, $params = NULL, $user_agent = NULL){
$site = explosion(':', $site);
if(isset($site[1]) and is_numeric($site[1])){
$port = $site[1];
}anders{
$port = 80;
}
$site = $site[0];
$data["methodCall"]["methodName"] = $methodName;
$param_count = count($params);
if(!$param_count){
$data["methodCall"]["params"] = NULL;
}anders{
for($n = 0; $n<$param_count; $n++){
$data["methodCall"]["params"]["param"][$n]["value"] = $params[$n];
}
}
$data = XML_serialize($data);
if(definiert('XMLRPC_DEBUG') und XMLRPC_DEBUG){
XMLRPC_debug('XMLRPC_request', "<p>Folgende Parameterliste zum Senden erhalten:</p>" . XMLRPC_show($params, 'print_r', true));
}
$conn = fsockopen ($site, $port); #öffne die Verbindung
if(!$conn){ #wenn die Verbindung nicht erfolgreich geöffnet wurde
if(definiert('XMLRPC_DEBUG') und XMLRPC_DEBUG){
XMLRPC_debug('XMLRPC_request', "<p>Verbindung fehlgeschlagen: Die Verbindung zu $site konnte nicht hergestellt werden.</p>");
}
return array(false, array('faultCode'=>10532, 'faultString'=>"Verbindung fehlgeschlagen: Die Verbindung zu $site konnte nicht hergestellt werden."));
}anders{
$headers =
„POST $location HTTP/1.0rn“ .
„Host: $sitern“ .
„Verbindung: schließenrn“ .
($user_agent ? "User-Agent: $user_agentrn" : '') .
„Inhaltstyp: text/xmlrn“ .
"Inhaltslänge: " . strlen($data) "rnrn";
fputs($conn, "$headers");
fputs($conn, $data);
if(definiert('XMLRPC_DEBUG') und XMLRPC_DEBUG){
XMLRPC_debug('XMLRPC_request', "<p>Folgende Anfrage gesendet:</p>nn" . XMLRPC_show($headers . $data, 'print_r', true));
}
#socket_set_blocking ($conn, false);
$response = "";
while(!feof($conn)){
$response .= fgets($conn, 1024);
}
fclose($conn);
#Kopfzeilen aus der Antwort entfernen
$data = XML_unserialize(substr($response, strpos($response, "rnrn")+4));
if(definiert('XMLRPC_DEBUG') und XMLRPC_DEBUG){
XMLRPC_debug('XMLRPC_request', "<p>Folgende Antwort erhalten:</p>nn" . XMLRPC_show($response, 'print_r', true) . "<p>Die in die folgenden Daten serialisiert wurde:< /p>nn" . XMLRPC_show($data, 'print_r', true));
}
if(isset($data['methodResponse']['fault'])){
$return = array(false, XMLRPC_adjustValue($data['methodResponse']['fault']['value']));
if(definiert('XMLRPC_DEBUG') und XMLRPC_DEBUG){
XMLRPC_debug('XMLRPC_request', "<p>Returning:</p>nn" . XMLRPC_show($return, 'var_dump', true));
}
return $return;
}anders{
$return = array(true, XMLRPC_adjustValue($data['methodResponse']['params']['param']['value']));
if(definiert('XMLRPC_DEBUG') und XMLRPC_DEBUG){
XMLRPC_debug('XMLRPC_request', "<p>Returning:</p>nn" . XMLRPC_show($return, 'var_dump', true));
}
return $return;
}
}
}
Funktion XMLRPC_response($return_value, $server = NULL){
$data["methodResponse"]["params"]["param"]["value"] = $return_value;
$return = XML_serialize($data);
if(definiert('XMLRPC_DEBUG') und XMLRPC_DEBUG){
XMLRPC_debug('XMLRPC_response', "<p>Folgende zurückzugebende Daten wurden empfangen:</p>nn" . XMLRPC_show($return_value, 'print_r', true));
}
header("Verbindung: schließen");
header("Content-Length: " . strlen($return));
header("Content-Type: text/xml");
header("Datum: " . date("r"));
if($server){
header("Server: $server");
}
if(definiert('XMLRPC_DEBUG') und XMLRPC_DEBUG){
XMLRPC_debug('XMLRPC_response', "<p>Folgende Antwort wurde gesendet:</p>nn" . XMLRPC_show($return, 'print_r', true));
}
echo $return;
}
Funktion XMLRPC_error($faultCode, $faultString, $server = NULL){
$array["methodResponse"]["fault"]["value"]["struct"]["member"] = array();
$temp = $array["methodResponse"]["fault"]["value"]["struct"]["member"];
$temp[0]["name"] = "faultCode";
$temp[0]["value"]["int"] = $faultCode;
$temp[1]["name"] = "faultString";
$temp[1]["value"]["string"] = $faultString;
$return = XML_serialize($array);
header("Verbindung: schließen");
header("Content-Length: " . strlen($return));
header("Content-Type: text/xml");
header("Datum: " . date("r"));
if($server){
header("Server: $server");
}
if(definiert('XMLRPC_DEBUG') und XMLRPC_DEBUG){
XMLRPC_debug('XMLRPC_error', "<p>Folgende Fehlerantwort wurde gesendet:</p>nn" . XMLRPC_show($return, 'print_r', true));
}
echo $return;
}
Funktion XMLRPC_convert_timestamp_to_iso8601($timestamp){
#nimmt einen Unix-Zeitstempel und konvertiert ihn in das von XMLRPC benötigte ISO8601
#ein Beispiel für eine ISO8601-Datumszeit ist „20010822T03:14:33“
return date("YmdTH:i:s", $timestamp);
}
Funktion XMLRPC_convert_iso8601_to_timestamp($iso8601){
return strtotime($iso8601);
}
Funktion count_numeric_items($array){
return is_array($array) ? count(array_filter(array_keys($array), 'is_numeric')) : 0;
}
Funktion XMLRPC_debug($function_name, $debug_message){
$GLOBALS['XMLRPC_DEBUG_INFO'][] = array($function_name, $debug_message);
}
Funktion XMLRPC_debug_print(){
if($GLOBALS['XMLRPC_DEBUG_INFO']){
echo "<table border="1" width="100%">n";
foreach($GLOBALS['XMLRPC_DEBUG_INFO'] as $debug){
echo "<tr><th style="vertical-align: top">$debug[0]</th><td>$debug[1]</td></tr>n";
}
echo "</table>n";
unset($GLOBALS['XMLRPC_DEBUG_INFO']);
}anders{
echo "<p>Noch keine Debugging-Informationen verfügbar.</p>";
}
}
Funktion XMLRPC_show($data, $func = "print_r", $return_str = false){
ob_start();
$func($data);
$output = ob_get_contents();
ob_end_clean();
if($return_str){
return „<pre>“ . htmlspecialchars($output) „</pre>n“;
}anders{
echo "<pre>", htmlspecialchars($output), "</pre>n";
}
}
?>
Beispiel für ein Serverprogramm, server.php
<?
include 'xml-rpc.inc.php';
//Methoden definieren, die remote aufgerufen werden können
$xmlrpc_methods=array();
$xmlrpc_methods['insertRecords']='insertRecords';
//Den Methodennamen und die vom Benutzer übergebenen Parameter abrufen
$xmlrpc_request = XMLRPC_parse($HTTP_RAW_POST_DATA);
$methodName = XMLRPC_getMethodName($xmlrpc_request);
$params = XMLRPC_getParams($xmlrpc_request);
if (!isset($xmlrpc_methods[$methodName])){
XMLRPC_error('1',"Die von Ihnen aufgerufene Methode existiert nicht");
}anders {
$xmlrpc_methods[$methodName]($params);
}
Funktion insertRecords($params){
if (emptyempty($params)){
XMLRPC_error('2',"Parameterfehler");
}
XMLRPC_response(XMLRPC_prepare('http://www.emtit.com'));
}
?>
Beispiel für einen PHP-Client, der die Servermethode
<?php
aufruft
include_once 'xml-rpc.inc';
$params=array(2,3);
$result=XMLRPC_request("127.0.0.1","/services/server.php","insertRecords",$params);//Die Serverdatei wird im Diensteordner abgelegt
print_r($result);
?>