Programming PHP

Often a server will call xmlrpc_server_register_method( ) many times, to expose
many functions.
When you’ve registered all your methods, call xmlrpc_server_call_method( ) to do
the dispatching:
$response = xmlrpc_server_call_method(server, request, user_data [, options]);
The request is the XML-RPC request, which is typically sent as HTTP POST data.
We fetch that through the $HTTP_RAW_POST_DATA variable. It contains the name of the
method to be called, and parameters to that method. The parameters are decoded
into PHP data types, and the function (times( ), in this case) is called.
A function exposed as an XML-RPC method takes two or three parameters:
$retval = exposed_function(method, args [, user_data]);
The method parameter contains the name of the XML-RPC method (so you can have
one PHP function exposed under many names). The arguments to the method are
passed in the array args, and the optional user_data parameter is whatever the
xmlrpc_server_call_method( )’s user_data parameter was.
The options parameter to xmlrpc_server_call_method( ) is an array mapping option
names to their values. The options are:
output_type
Controls the data encoding used. Permissible values are: "php" or "xml" (default).
verbosity
Controls how much whitespace is added to the output XML to make it readable
to humans. Permissible values are: "no_white_space", "newlines_only", and
"pretty" (default).
escaping
Controls which characters are escaped, and how. Multiple values may be given
as a subarray. Permissible values are: "cdata", "non-ascii" (default), "non-print"
(default), and "markup" (default).
versioning
Controls which web service system to use. Permissible values are: "simple",
"soap 1.1", "xmlrpc" (default for clients), and "auto" (default for servers, meaning
“whatever format the request came in”).
encoding
Controls the character encoding of the data. Permissible values include any valid
encoding identifiers, but you’ll rarely want to change it from "iso-8859-1" (the
default).
Clients
An XML-RPC client issues an HTTP request and parses the response. The xmlrpc
extension that ships with PHP can work with the XML that encodes an XML-RPC
282 | Chapter 11: XML
This is the Title of the Book, eMatter Edition
Copyright © 2002 O’Reilly & Associates, Inc. All rights reserved.