[edit] Last updated: Fri, 14 Jun 2013

xmlrpc_set_type

(PHP 4 >= 4.1.0, PHP 5)

xmlrpc_set_type — Définit le type xmlrpc, base64 ou datetime, d'une valeur PHP

Description

bool xmlrpc_set_type ( string &$value , string $type )

xmlrpc_set_type() définit le type XMLRPC, base64 ou datetime, pour une chaîne PHP.

Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et, concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS ! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.

Liste de paramètres

value: Valeur dont on veut modifier le type
type: base64 ou datetime

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient. En cas de réussite, value sera converti en objet.

Exemples

Exemple #1 Exemple avec xmlrpc_set_type()


<?php

$params = date("Ymd\TH:i:s", time());
xmlrpc_set_type($params, 'datetime');
echo xmlrpc_encode($params);

?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

<?xml version="1.0" encoding="utf-8"?>
<params>
<param>
 <value>
  <dateTime.iso8601>20090322T23:43:03</dateTime.iso8601>
 </value>
</param>
</params>

Erreurs / Exceptions

Émet une alerte de type E_WARNING lorsque le type n'est pas supporté par XMLRPC.

Extensions pour Windows uniquement

xmlrpc_server_register_method

[edit] Last updated: Fri, 14 Jun 2013

add a note User Contributed Notes xmlrpc_set_type - [3 notes]

down

bmatheny at mobocracy dot net ¶

7 years ago


The following code segfaults some older (pre 5.1.2) versions of PHP:



$foo = date('c', time());

xmlrpc_set_type($foo, 'datetime');



Please upgrade before reporting as a bug.

down

shem((at))etkDOTca [aka.Przemyslaw Szot] ¶

8 years ago


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);

down

kelly at seankelly dot biz ¶

10 years ago


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