X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=doc%2Fxmlrpc_php.xml;h=139ef6c7a0e20a0788d64bf677934469cb279bab;hb=05ba4479e2f74f0a51797ca268b1b8751f544614;hp=6f42602c7fd4ebf5dd2aa8c9f920bbc31d4c709c;hpb=b6815973f2e7908d5b0e546c60774ab523181386;p=plcapi.git diff --git a/doc/xmlrpc_php.xml b/doc/xmlrpc_php.xml index 6f42602..139ef6c 100644 --- a/doc/xmlrpc_php.xml +++ b/doc/xmlrpc_php.xml @@ -4,15 +4,14 @@ "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"> XML-RPC for PHP - version 3.0.0 beta + version 3.0.0 - Sep 5, 2009 + June 15, 2014 @@ -114,7 +113,8 @@ $Id: xmlrpc_php.xml,v 1.27 2008/09/19 18:35:33 ggiunta Exp $ url="http://usefulinc.com/">Useful Information Company. As of the 1.0 stable release, the project was opened to wider involvement and moved to SourceForge. + url="http://phpxmlrpc.sourceforge.net/">SourceForge; later, to Github A list of XML-RPC implementations for other languages such as Perl and Python can be found on the + + 3.0.0 + + Note: this is the last release of the library that will support PHP 5.1 and up. + Future releases will target php 5.3 as minimum supported version. + + + + when using curl and keepalive, reset curl handle if we did not get back an http 200 response (eg a 302) + + + + omit port on http 'Host' header if it is 80 + + + + test suite allows interrogating https servers ignoring their certs + + + + method setAcceptedCompression was failing to disable reception of compressed responses if the + client supported them + + + + + 3.0.0 beta @@ -459,7 +486,7 @@ $Id: xmlrpc_php.xml,v 1.27 2008/09/19 18:35:33 ggiunta Exp $ The wrap_php_function and wrap_xmlrpc_method functions have been moved out of the base library file xmlrpc.inc into - a file of their own: xmlrpc_wrappers.inc. You + a file of their own: xmlrpc_wrappers.php. You will have to include() / require() it in your scripts if you have been using those functions. For increased security, the automatic rebuilding of php object instances out of received xmlrpc structs @@ -806,9 +833,6 @@ $Id: xmlrpc_php.xml,v 1.27 2008/09/19 18:35:33 ggiunta Exp $ wrap_php_function and wrap_xmlrpc_method, and has many caveats, with php being a typeless language and all... - - With PHP versions lesser than 5.0.3 wrapping of php functions - into xmlrpc methods is not supported yet. @@ -855,11 +879,7 @@ $Id: xmlrpc_php.xml,v 1.27 2008/09/19 18:35:33 ggiunta Exp $ configuration. The minimum supported PHP version is - 5.0. - - Automatic generation of xml-rpc methods from php functions is only - supported with PHP version 5.0.3 and later (note that the lib will - generate some warnings with PHP 5 in strict error reporting mode). + 5.3. If you wish to use SSL or HTTP 1.1 to communicate with remote servers, you need the "curl" extension compiled into your PHP @@ -893,7 +913,7 @@ $Id: xmlrpc_php.xml,v 1.27 2008/09/19 18:35:33 ggiunta Exp $ - lib/xmlrpc_wrappers.inc + lib/xmlrpc_wrappers.php helper functions to "automagically" convert plain php @@ -977,7 +997,7 @@ $Id: xmlrpc_php.xml,v 1.27 2008/09/19 18:35:33 ggiunta Exp $ - demo/demo1.txt, demo/demo2.txt, demo/demo3.txt + demo/demo1.xml, demo/demo2.xml, demo/demo3.xml XML-RPC responses captured in a file for testing purposes (you @@ -1115,9 +1135,9 @@ $Id: xmlrpc_php.xml,v 1.27 2008/09/19 18:35:33 ggiunta Exp $ The XML-RPC for PHP development is hosted on phpxmlrpc.sourceforge.net. + url="https://github.com/gggeek/phpxmlrpc">github.com/gggeek/phpxmlrpc. Bugs, feature requests and patches can be posted to the project's + url="https://github.com/gggeek/phpxmlrpc/issues">project's website. @@ -1338,9 +1358,9 @@ $myStruct = new xmlrpcval( array( "street" => new xmlrpcval("Fifht Ave", "string"), "city" => new xmlrpcval("NY", "string") - ), + ), "struct") - ), + ), "struct"); @@ -1781,7 +1801,7 @@ $msg = new xmlrpcmsg("examples.getStateName", array(new xmlrpcval(23, "int"))); parseResponse. This method is useful to construct responses from pre-prepared - files (see files demo1.txt, demo2.txt, demo3.txt + files (see files demo1.xml, demo2.xml, demo3.xml in this distribution). It processes any HTTP headers it finds, and does not close the file handle. @@ -2388,7 +2408,7 @@ $client = new xmlrpc_client("/RPC2", "betty.userland.com", 80); Example usage: -$client = new xmlrpc_client("phpxmlrpc.sourceforge.net/server"); +$client = new xmlrpc_client("phpxmlrpc.sourceforge.net/server.php"); $client->return_type = 'phpvals'; $message = new xmlrpcmsg("examples.getStateName", array(new xmlrpcval(23, "int"))); $resp = $client->send($message); @@ -3642,7 +3662,7 @@ else { transparently carried out by the lib, while datetime vals are passed around as strings). - Known limitations: requires PHP 5.0.3 +; only works for + Known limitations: only works for user-defined functions, not for PHP internal functions (reflection does not support retrieving number/type of params for those); the wrapped php function will not be able to programmatically return an @@ -4074,7 +4094,7 @@ if (!$resp->faultCode()) PHP-XMLRPC only supports the ISO 8859-1 and UTF8 character sets. The net result of this situation is that those extra characters will not be properly encoded, and will be received at the other end of the - XML-RPC tranmission as "garbled data". Unfortunately the library cannot + XML-RPC transmission as "garbled data". Unfortunately the library cannot provide real support for CP1252 because of limitations in the PHP 4 xml parser. Luckily, we tried our best to support this character set anyway, and, since version 2.2.1, there is some form of support, left commented @@ -4085,7 +4105,7 @@ if (!$resp->faultCode()) xmlrpc.inc (you can search for the string "1252"), then set $GLOBALS['xmlrpc_internalencoding']='CP1252'; Please note that all incoming data will then be fed to your application - as UTF-8 to avoid any potentail data loss. + as UTF-8 to avoid any potential data loss.