PHP: xmlrpc_set_type

説明

bool xmlrpc_set_type ( string value, string type)

警告

この関数は、 実験的なステータスにあります。これは、この関数の動作、関数名、ここで書かれていること全てがPHPの将来のバージョンで予告なく変更される可能性があることを意味します。注意を喚起するとともに自分のリスクでこの関数を使用して下さい。

警告

この関数は、現在のところ詳細な情報はありません。引数のリストのみが記述されています。

add a note User Contributed Notes
xmlrpc_set_type

shem((at))etkDOTca [aka.Przemyslaw Szot]
30-Oct-2004 11:23


Once you use the xmlrpc_set_type function, the data is encoded into a PHP object.  In your XMLRPC server, in order to access the data you must be able to access the necessary part of the object.



So.. to expend on the example above:



<---------- CLIENT ---------->

$string = "My logging event."; 

$date = "20030115T12:22:37"; // Must be this format 

$binary = fread($fp, 128); 

xmlrpc_set_type(&$date, "datetime"); 

xmlrpc_set_type(&$binary, "base64"); 

$xmlrpcReq = xmlrpc_encode_request("log.data", array($string, $date, $binary)); 



In order to retrieve the binary file data you would need to get the scalar portion of the object:



<---------- SERVER ------------>

$string=$params[0];

$date_obj=$params[1];

$binary_obj=$params[2];



$date=$date_obj->scalar;

$binary_data=$binary_obj->scalar;



// Then you can proceed to write the binary

fwrite($handle,$binary_data);

kelly at seankelly dot biz
28-Dec-2002 04:53


The problem is that PHP has a string type which is also used to hold binary data and dates.  But XML-RPC defines three separate types for strings, binary data, and dates.  How do you tell how you want strings encoded?  That's where this function comes in.





Suppose the XML-RPC method "log.data" took a string, a date, and a binary object.  To tell XML-RPC that the date (which is a PHP string) is a really a date and that the binary data (which is also a PHP string) is really binary data, try:





$string = "My logging event.";


$date = "20030115T12:22:37"; // Must be this format


$binary = fread($fp, 128);


xmlrpc_set_type(&$date, "datetime");


xmlrpc_set_type(&$binary, "base64");


$xmlrpcReq = xmlrpc_encode_request("log.data", array($string, $date, $binary));





Note the reference passing in the calls to xmlrpc_set_type; that enables the function to change the values from strings into what xmlrpc_encode/_request expects (which are objects that include a bonus field that tells the desired XML-RPC type).

add a note


	downloads \| documentation \| faq \| getting help \| mailing lists \| reporting bugs \| php.net sites \| links \| my php.net

search for in the