PHP: xmlrpc_encode_request

Description

string xmlrpc_encode_request ( string method, mixed params [, array output_options])

Warning

This function is EXPERIMENTAL. The behaviour of this function, the name of this function, and anything else documented about this function may change without notice in a future release of PHP. Use this function at your own risk.

Warning

This function is currently not documented; only the argument list is available.

add a note User Contributed Notes
xmlrpc_encode_request

<URL:http://www.dlitz.net/go/contact/>
04-May-2004 08:28


Note that as far as I can tell, the &#10; characters generated by PHP in the base64 fields don't appear to violate the XML-RPC standard at all.  XML-RPC messages *are* in XML format, and as such, the XML entities should be getting decoded before being passed to a base64 decoder.  So, the previously-mentioned Jakarta-based XML-RPC server appears to violate the XML spec.  i.e. There's nothing here that needs to be "fixed" in PHP.

Brian
10-Feb-2003 05:00


As per documentation on xmlrpc-epi's site, this function

also can create both a methodCall and a methodResponse.



to create a methodCall:  

     xmlrpc_encode_request(null,$params);



to create a methodRequest:

      xmlrpc_encode_request("methodName",$params);



---

The documentation on this is abysmal.  I know this is opensource, but it has been around for quite a while now.

kelly at seankelly dot biz
29-Dec-2002 01:02


Binary strings (set with xmlrpc_set_type) go into a <base64>...</base64> block like you'd expect. But after every 80th character, this function inserts the XML entity "&#10;", which is a Unicode newline, as if to cause a line-wrap, which is admittedly silly.



Silly though it may be, it causes real problems for some XML-RPC servers, such as http://jakarta.apache.org/xmlrpc/ (nee Helma). Stripping out those entities with something like



$req = preg_replace('/&#10;/', '', xmlrpc_encode_request("my.method", $args));



works around the problem.

hfuecks at pinkgoblin dot com
15-Aug-2002 06:06


This function should be used by an XML-RPC client to create an XML payload for an XML-RPC request;



<?php

$params = "system.methodSignature";

$method = "system.methodHelp";

$request = xmlrpc_encode_request($method,$params);

echo ( $request );

?>



Produces;



<?xml version='1.0' encoding="iso-8859-1" ?>

<methodCall>

<methodName>system.methodHelp</methodName>

<params>

 <param>

  <value>

   <string>system.methodSignature</string>

  </value>

 </param>

</params>

</methodCall>



The second argument recognises the type of variable and generates the correct XML-RPC structure. See xmlrpc_encode() for more details.

add a note


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

search for in the