1 XML-RPC for PHP version 4.6.1 - 2022/2/15
3 * fixed: one php warning with php 8 and up
6 XML-RPC for PHP version 4.6.0 - 2021/12/9
8 * fixed: compatibility with php 8.1
10 * improved: when encoding utf8 text into us-ascii xml, use character entity references for characters number 0-31
11 (ascii non printable characters), as we were already doing when encoding iso-8859-1 text into us-ascii xml
13 * new: method `Server::getDispatchMap()`. Useful for non-child classes which want to f.e. introspect the server
15 * new: increase flexibility in class composition by adopting a Dependency Injection (...ish) pattern:
16 it is now possible to swap out the Logger, XMLParser and Charset classes with similar ones of your own making.
18 // 1. create an instance of a custom character encoder
19 // $myCharsetEncoder = ...
20 // 2. then use it while serializing a Request:
21 Request::setCharsetEncoder($myCharsetEncoder);
22 $request->serialize($funkyCharset);
24 * new: method `XMLParser::parse()` acquired a 4th argument
26 * new: method `Wrapper::wrapPhpClass` allows to customize the names of the phpxmlrpc methods by stripping the original
27 class name and accompanying namespace and replace it with a user-defined prefix, via option `replace_class_name`
29 * new: `Response` constructor gained a 4th argument
31 * deprecated: properties `Response::hdrs`, `Response::_cookies`, `Response::raw_data`. Use `Response::httpResponse()` instead.
32 That method returns an array which also holds the http response's status code - useful in case of http errors.
34 * deprecated: method `Request::createPayload`. Use `Request::serialize` instead
36 * deprecated: property `Request::httpResponse`
38 * improved: `Http::parseResponseHeaders` now throws a more specific exception in case of http errors
40 * improved: Continuous Integration is now running on Github Actions instead of Travis
43 XML-RPC for PHP version 4.5.2 - 2021/1/11
45 * improved: better phpdocs in the the php code generated by the Wrapper class
47 * improved: debugger favicon and page title when used from the phpjsonrpc library
49 * fixed: allow `Encoder::decode` to properly support different target character sets for polyfill-xmlrpc decode functions
51 * improved: allow usage of 'epivals' for the 'parameters_type' member of methods definitions in the Server dispatch map
54 XML-RPC for PHP version 4.5.1 - 2021/1/3
56 * improved: made it easier to subclass the Helper\Charset class by allowing `instance` to use late static binding
58 * fixed: reinstated access to xmlrpc_server->dmap (for users of the v3 API)
60 * fixed: method `xmlrpc_encode_entitites` (for users of the v3 API)
62 * improved: split the code of the demo server in multiple files, describing better the purpose of each
65 XML-RPC for PHP version 4.5.0 - 2020/12/31
67 * new: it is now possible to control the precision used when serializing DOUBLE values via usage of
68 `PhpXmlRpc::$xmlpc_double_precision`
70 * fixed: `Encoder::encode` would not correctly encode DateTime and DateTimeImmutable objects
72 * improvements to to the Helper\Date class in rejecting invalid date strings
74 * improvements to the Wrapper class in identifying required arguments types from source code phpdoc: support 'array[]',
75 'DateTime' and 'DateTimeImmutable'
77 * improvements to the support of the XMLRPC extension emulation (now provided by the phpxmlrpc/polyfill-xmlrpc package)
79 * minor improvements to the Charset helper: it now loads character set conversion tables on demand, leading to
80 slightly lower memory usage and faster execution time when using UTF8 everywhere.
81 NB: take care if you have subclassed it!
83 * new method: `Server::isSyscall` - mostly of use to Server subclasses and friend classes such as introspectors
85 * internal method `XMLParser::xmlrpc_ee` now accepts 3 states for its 3rd parameter instead of a bool
87 * improvements in the inline phpdoc: tagged many methods and class member as reserved for internal usage only
89 * minor improvements in the debugger to allow easier integration of phpxmlrpc/jsonrpc and friends
91 * reorganized the test suite to be more manageable
93 * removed obsolete files from the 'extras' folder; updated and moved to the 'demo' folders the perl and python
94 client scripts; moved benchmark.php and verify_compat.php to the 'extras' folder
97 XML-RPC for PHP version 4.4.3 - 2020/12/17
99 * fixed: compatibility with PHP 8.0 (fixes to the debugger, to the server's 'system.methodHelp' method and to the
100 PhpXmlRpc\Wrapper class).
101 Note that method `Value::structeach` has not been removed from the API, but it is _not_ supported when running
102 on PHP 8.0 or later - in that case it will always throw an Error.
104 * improvements to the test stack: it is now possible to run it via Docker besides Travis; avoid using _any_ external
105 server when running tests; run Travis tests also on php 8.0; bump PHPUnit versions in use
108 XML-RPC for PHP version 4.4.2 - 2020/3/4
110 * fixed: `client->setCookie()` bug: cookie values that contain spaces are now properly encoded in a way that gets them
111 decoded back to spaces on the receiving end if the server running on php 7.4 (or does RFC-compliant cookie decoding).
112 Beforehand we were encoding spaces to '+' characters.
115 XML-RPC for PHP version 4.4.1 - 2019/7/29
117 * fixed: allow handling huge xml messages (>=10MB) (issue #71)
119 * improved: make it easier to overtake the library's usage of `error_log`
122 XML-RPC for PHP version 4.3.2 - 2019/5/27
124 * fixed: remove one php 7.2 warning when using the v3 api
126 * improved: the Travis tests are now run with all php versions from 5.6 to 7.3. We dropped tests with php 5.3, 5.4 and 5.5
129 XML-RPC for PHP version 4.3.1 - 2018/1/20
131 * fixed: error when using https in non-curl mode
133 * fixed: compatibility of tests with php 7.2
135 * fixed: html injection in sample code
137 * fixed: warnings emitted by the *legacy* server in xmlrpcs.inc
139 * fixed: encoding of php variables of type 'resource' when using xmlrpc_encode in php-compatibility mode
141 * fixed: bad html tag in sample code
143 * improved: text of error messages
146 XML-RPC for PHP version 4.3.0 - 2017/11/6
148 * fixed: compatibility with Basic/Digest/NTLM auth when using client in cURL mode (issue #58)
150 * improved: added unit tests for Basic and Digest http auth. Also improved tests suite
152 * new: allow to force usage of curl for http 1.0 calls, as well as plain socket for https calls, via the method
153 `Client::setUseCurl()`
156 XML-RPC for PHP version 4.2.2 - 2017/10/15
158 * fixed: compatibility with Lighttpd target servers when using client in cURL mode and request body size > 1024 bytes (issue #56)
161 XML-RPC for PHP version 4.2.1 - 2017/9/3
163 * fixed: compatibility with php 7.2 (issue #55)
166 XML-RPC for PHP version 4.2.0 - 2017/6/30
168 * improved: allow also DateTimeImmutable objects to be detected as a date when encoding
171 XML-RPC for PHP version 4.1.1 - 2016/10/1
173 * fixed: error in server class: undefined function php_xmlrpc_encode (only triggered when not using the compatibility
174 shim with old versions)
177 XML-RPC for PHP version 4.1.0 - 2016/6/26
179 * improved: Added support for receiving <I8> and <EX:I8> integers, sending <I8>
181 If php is compiled in 32 bit mode, and an i8 int is received from a 3rd party, and error will be emitted.
182 Integers sent from the library to 3rd parties can be encoded using the i8 tag, but default to using 'int' by default;
183 the developer will have to create values as i8 explicitly if needed.
184 The library does *not* check if an outgoing integer is too big to fit in 4 bytes and convert it to an i8 automatically.
187 XML-RPC for PHP version 4.0.1 - 2016/3/27
189 * improved: all of the API documentation has been moved out of the manual and into the source code phpdoc comments
191 * fixed: when the internal character set is set to UTF-8 and the client sends requests (or the server responses), too
192 many characters were encoded as numeric entities, whereas some, like åäö, needed not not be
194 * fixed: the 'valtyp' property of Response was not present in all cases; the ValType property had been added by error
198 XML-RPC for PHP version 4.0.0 - 2016/1/20
200 This release does away with the past and starts a transition to modern-world php.
202 Code has been heavily refactored, taking care to preserve backwards compatibility as much as possible,
203 but some breackage is to be expected.
205 The minimum required php version has been increased to 5.3, even though we strongly urge you to use
206 more recent versions.
208 PLEASE READ CAREFULLY THE NOTES BELOW to insure a smooth upgrade.
210 * new: introduction of namespaces and full OOP.
212 All php classes have been renamed and moved to separate files.
213 Class autoloading can now be done in accord with the PSR-4 standard.
214 All global variables and global functions have been removed.
215 Iterating over xmlrpc value objects is now easier thank to support for ArrayAccess and Traversable interfaces.
217 Backward compatibility is maintained via lib/xmlrpc.inc, lib/xmlrpcs.inc and lib/xmlrpc_wrappers.inc.
218 For more details, head on to doc/api_changes_v4.md
220 * changed: the default character encoding delivered from the library to your code is now utf8.
221 It can be changed at any time setting a value to PhpXmlRpc\PhpXmlRpc::$xmlrpc_internalencoding
223 * improved: the library now accepts requests/responses sent using other character sets than UTF-8/ISO-8859-1/ASCII.
224 This only works when the mbstring php extension is enabled.
226 * improved: no need to call anymore $client->setSSLVerifyHost(2) to silence a curl warning when using https
227 with recent curl builds
229 * improved: the xmlrpcval class now supports the interfaces Countable and IteratorAggregate
231 * improved: a specific option allows users to decide the version of SSL to use for https calls.
232 This is useful f.e. for the testing suite, when the server target of calls has no proper ssl certificate,
233 and the cURL extension has been compiled with GnuTLS (such as on Travis VMs)
235 * improved: the function wrap_php_function() now can be used to wrap closures (it is now a method btw)
237 * improved: all wrap_something() functions now return a closure by default instead of a function name
239 * improved: debug messages are not html-escaped any more when executing from the command line
241 * improved: the library is now tested using Travis ( https://travis-ci.org/ ).
242 Tests are executed using all php versions from 5.3 to 7.2; code-coverage information
243 is generated using php 5.6 and uploaded to both Code Coverage and Scrutinizer online services
245 * improved: phpunit is now installed via composer, not bundled anymore
247 * improved: when phpunit is used to generate code-coverage data, the code executed server-side is accounted for
249 * improved: the test suite has basic checks for the debugger and demo files
251 * improved: more tests in the test suite
253 * fixed: the server would not reset the user-set debug messages between subsequent service() calls
255 * fixed: the server would not reset previous php error handlers when an exception was thrown by user code and
256 exception_handling set to 2
258 * fixed: the server would fail to decode a request with ISO-8859-1 payload and character set declaration in the xml
261 * fixed: the client would fail to decode a response with ISO-8859-1 payload and character set declaration in the xml
264 * fixed: the function decode_xml() would not decode an xml with character set declaration in the xml prolog
266 * fixed: the client can now successfully call methods using ISO-8859-1 or UTF-8 characters in their name
268 * fixed: the debugger would fail sending a request with ISO-8859-1 payload (it missed the character set declaration).
269 It would have a hard time coping with ISO-8859-1 in other fields, such as e.g. the remote method name
271 * fixed: the debugger would generate a bad payload via the 'load method synopsis' button for signatures containing NULL
272 or undefined parameters
274 * fixed: the debugger would generate a bad payload via the 'load method synopsis' button for methods with multiple
277 * improved: the debugger is displayed using UTF-8, making it more useful to debug any kind of service
279 * improved: echo all debug messages even when there are characters in them which php deems to be in a wrong encoding;
280 previously those messages would just disappear (this is visible e.g. in the debugger)
282 * changed: debug info handling
283 - at debug level 1, the rebuilt php objects are not dumped to screen (server-side already did that)
284 - at debug level 1, curl communication info are not dumped to screen
285 - at debug level 1, the tests echo payloads of failures; at debug level 2 all payloads
287 * improved: makefiles have been replaced with a php_based pakefile
289 * improved: the source for the manual is stored in asciidoc format, which can be displayed natively by GitHub
290 with nice html formatting. Also the HTML version generated by hand and bundled in tarballs is much nicer
291 to look at than previous versions
293 * improved: all php code is now formatted according to the PSR-2 standard
296 XML-RPC for PHP version 3.0.0 - 2014/6/15
298 This release corrects all bugs that have been reported and successfully reproduced since
301 The requirements have increased to php 5.1.0 - which is still way older than what you should be running for any serious
304 It also is the first release to be installable via composer.
306 See the Changelog file or the pdf docs for a complete list of changes.
309 XML-RPC for PHP version 3.0.0 beta - 2009/09/05
311 This is the first release of the library to only support PHP 5.
312 Some legacy code has been removed, and support for features such as exceptions
313 and dateTime objects introduced.
315 The "beta" tag is meant to indicate the fact that the refactoring has been more widespread
316 than in precedent releases and that more changes are likely to be introduced with time -
317 the library is still considered to be production quality.
319 * improved: removed all usage of php functions deprecated in php 5.3, usage of assign-by-ref when creating new objects
321 * improved: add support for the <ex:nil/> tag used by the apache library, both in input and output
322 * improved: add support for dateTime objects in both in php_xmlrpc_encode and as parameter for constructor of xmlrpcval
323 * improved: add support for timestamps as parameter for constructor of xmlrpcval
324 * improved: add option 'dates_as_objects' to php_xmlrpc_decode to return dateTime objects for xmlrpc datetimes
325 * improved: add new method SetCurlOptions to xmrlpc_client to allow extra flexibility in tweaking http config, such as
326 explicitly binding to an ip address
327 * improved: add new method SetUserAgent to xmrlpc_client to to allow having different user-agent http headers
328 * improved: add a new member variable in server class to allow fine-tuning of the encoding of returned values when the
329 server is in 'phpvals' mode
330 * improved: allow servers in 'xmlrpcvals' mode to also register plain php functions by defining them in the dispatch map
332 * improved: catch exceptions thrown during execution of php functions exposed as methods by the server
333 * fixed: bad encoding if same object is encoded twice using php_xmlrpc_encode
336 XML-RPC for PHP version 2.2.2 - 2009/03/16
338 This release corrects all bugs that have been reported and sucesfully reproduced since
340 Regardless of the intimidating message about dropping PHP 4 support, it still does
341 support that ancient, broken and insecure platform.
344 * fixed: php warning when receiving 'false' in a bool value
345 * fixed: improve robustness of the debugger when parsing weird results from non-compliant servers
346 * fixed: format floating point values using the correct decimal separator even when php locale is set to one that uses
348 * fixed: use feof() to test if socket connections are to be closed instead of the number of bytes read (rare bug when
349 communicating with some servers)
350 * fixed: be more tolerant in detection of charset in http headers
351 * fixed: fix encoding of UTF8 chars outside of the BMP plane
352 * fixed: fix detection of zlib.output_compression
353 * improved: allow the add_to_map server method to add docs for single params too
354 * improved: added the possibility to wrap for exposure as xmlrpc methods plain php class methods, object methods and
358 XML-RPC for PHP version 2.2.1 - 2008/03/06
360 This release corrects all bugs that have been reported and sucesfully reproduced.
361 It is the last release of the library that will support PHP 4.
363 * fixed: work around bug in php 5.2.2 which broke support of HTTP_RAW_POST_DATA
364 * fixed: is_dir parameter of setCaCertificate() method is reversed
365 * fixed: a php warning in xmlrpc_client creator method
366 * fixed: parsing of '1e+1' as valid float
367 * fixed: allow errorlevel 3 to work when prev. error handler was a static method
368 * fixed: usage of client::setcookie() for multiple cookies in non-ssl mode
369 * improved: support for CP1252 charset is not part or the library but almost possible
370 * improved: more info when curl is enabled and debug mode is on
373 XML-RPC for PHP version 2.2 - 2007/02/25
375 This release corrects a couple of bugs and adds a few minor features.
377 * fixed: debugger errors on php installs with magic_quotes_gpc on
378 * fixed: support for https connections via proxy
379 * fixed: wrap_xmlrpc_method() generated code failed to properly encode php objects
380 * improved: slightly faster encoding of data which is internally UTF-8
381 * improved: debugger always generates a 'null' id for jsonrpc if user omits it
382 * new: debugger can take advantage of a graphical value builder
383 (it has to be downloaded separately, as part of jsxmlrpc package)
384 * new: support for the <NIL/> xmlrpc extension
385 * new: server support for the system.getCapabilities xmlrpc extension
386 * new: wrap_xmlrpc_method() accepts two new options: debug and return_on_fault
389 XML-RPC for PHP version 2.1 - 2006/08/28
391 This release corrects quite a few bugs and adds some interesting new features.
392 There is a minor security enhancement and overall speedup too.
394 It has been tested with PHP 4.0.5 up to 4.4.4 and 5.1.5.
395 Please note that 404pl1 is NOT supported, and has not been since 2.0.
397 *** PLEASE READ CAREFULLY BELOW ***
399 CHANGES THAT MIGHT AFFECT DEPLOYED APPLICATIONS:
401 The wrap_php_function and wrap_xmlrpc_method functions have been moved out of
402 the base library file xmlrpc.inc into a file of their own: xmlrpc_wrappers.inc.
403 You will have to include() / require() it in your scripts if you have been using
406 For increased security, the automatic rebuilding of php object instances out of
407 received xmlrpc structs in wrap_xmlrpc_method() has been disabled (but it can be
408 optionally reenabled).
410 The constructor of xmlrpcval() values has seen major changes, and it will not
411 throw a php warning anymore when invoked using an unknown xmlrpc type: the
412 error will only be written to php error log. Also new xmlrpcval('true', 'boolean')
413 is not supported anymore.
417 The new function php_xmlrpc_decode_xml() will take the xml representation of
418 either an xmlrpc request, response or single value and return the corresponding
419 php-xmlrpc object instance.
421 Both wrap_php_function() and wrap_xmlrpc_method() functions accept many more
422 options to fine tune their behaviour, including one to return the php code to
423 be saved and later used as standalone php script.
425 A new function wrap_xmlrpc_server() has been added, to wrap all (or some) of the
426 methods exposed by a remote xmlrpc server into a php class.
428 Lib internals have been modified to provide better support for grafting extra
429 functionality on top of it. Stay tuned for future releases of the EXTRAS package.
431 Last but not least a new file has been added: verify_compat.php, to help users
432 diagnose the level of compliance of the current php install with the library.
436 * fixed bug 1311927: client not playing nice with some proxy/firewall on ports != 80
437 * fixed bug 1334340: all ereg_ functions have been replaced with corresponding preg_
438 * fixed bug: wrong handling of 'deflate' http encoding, both server and client side
439 * fixed bug: sending compressed responses when php output compression is enabled was not working
440 * fixed bug: addarray() and addstruct() where not returning 1 when adding data to already initialized values
441 * fixed bug: non-ascii chars used in struct element names where not being encoded correctly
442 * restored compatibility with php 4.0.5 (for those poor souls still stuck on it)
443 * server->service() now returns either the payload or xmlrpcresp instance
444 * server->add_to_map() now accepts methods with no param definitions
445 * added new function: php_xmlrpc_decode_xml()
446 * added new function: wrap_xmlrpc_server()
447 * major improvements and security enhancements to wrap_php_function() and wrap_xmlrpc_method()
448 * documentation for single parameters of exposed methods can be added to the dispatch map
449 (and turned into html docs in conjunction with a future release of the extras package)
450 * full response payload is saved into xmlrpcresp object for further debugging
451 * stricter parsing of incoming xmlrpc messages: two more invalid cases are now detected
452 (double data element inside array and struct/array after scalar inside value element)
453 * debugger can now generate code that wraps a remote method into php function (works for jsonrpc, too)
454 * debugger has better support for being activated via a single GET call (for integration into other tools?)
455 * more logging of errors in a lot of situations
456 * javadoc documentation of lib files almost complete
457 * the usual amount of new testcases in the testsuite
458 * many performance tweaks and code cleanups
459 * added foundation for emulating the API of the xmlrpc extension (extras package needed)
462 XML-RPC for PHP version 2.0 - 2006/04/24
464 I'm pleased to announce XML-RPC for PHP version 2.0, final.
466 With respect to the last release candidate, this release corrects a few small
467 bugs and adds a couple of new features: more authentication options (digest and
468 ntlm for servers, ntlm for proxies, and some https custom certificates stuff);
469 all the examples have been reviewed and some demo files added,
470 including a ready-made xmlrpc proxy (useful e.g. for ajax calls, when the xmlrpc
471 client is a browser); the server logs more warning messages for incorrect situations;
472 both client and server are more tolerant of commonly-found mistakes.
473 The debugger has been upgraded to reflect the new client capabilities.
477 * fixed bug: method xmlrpcval::structmemexists($value) would not work
478 * fixed bug: wrap_xmlrpc_method would fail if invoked with a client object that
479 has return_type=phpvals
480 * fixed bug: in case of call to client::multicall without fallback and server error
481 * fixed bug: recursive serialization of xmlrpcvals loosing specified UTF8 charset
482 * fixed bug: serializing to ISO-8859-1 with php 5 would raise an error if non-ascii
483 chars where found when decoding
484 * new: client can use NTLM and Digest authentication methods for https and http 1.1
485 connections; authentication to proxy can be set to NTLM, too
486 * new: server tolerates user functions returning a single xmlrpcval object instead
488 * new: server does more checks for presence and correct return type of user
489 coded method handling functions, and logs inconsistencies to php error log
490 * new: client method SetCaCertificate($cert, $is_dir) to validate server against
491 * new: both server and client tolerate receiving 'true' and 'false' for bool values
492 (which btw are not valid according to the xmlrpc spec)
495 XML-RPC for PHP version 2.0RC3 - 2006/01/22
497 This release corrects a few bugs and adds some interesting new features.
498 It has been tested with PHP up to 4.4.2 and 5.1.2.
500 * fixed bug: server not recognizing clients that declare support for http compression
501 * fixed bug: serialization of new xmlrpcval (8, 'string') when internal encoding
503 * fixed bug: serialization of new xmlrpcval ('hello', 'int') would produce
505 * new: let the server accept 'class::method' syntax in the dispatch map
506 * new: php_xmlrpc_decode() can decode xmlrpcmessage objects
507 * new: both client and server can specify a charset to be used for serializing
508 values instead of the default 'US-ASCII+xml-entities-for-other-characters'.
509 Values allowed: ISO-8859-1 and UTF-8
510 * new: the server object can register 'plain' php functions instead of functions
511 that accept a single parameter of type xmlrpcmsg. Faster, uses less memory
512 (but comes with minor drawbacks as well, read the manual for more details)
513 * new: client::setDebug(2) can be used to have the request payload printed to
514 screen before being sent
515 * new: server::service($data) lets user parse data other than POST body, for
516 easier testing / subclassing
517 * changed: framework-generated debug messages are sent back by the server base64
518 encoded, to avoid any charset/xml compatibility problem
521 The usual refactoring of a lot of (private) methods has taken place, with new
522 parameters added to some functions.
523 Javadoc documentation has been improved a lot.
524 The HTML documentation has been shuffled around a bit, hoping to give it a more
525 logical organization.
527 The experimental support for the JSON protocol has been removed, and will be
528 packaged as a separate download with some extra very interesting stuff (human
529 readable auto-generated documentation, anyone?).
532 XML-RPC for PHP version 2.0RC2 - 2005/11/22
534 This release corrects a few bugs and adds basically one new method for better
537 * fixed two bugs that prevented xmlrpc calls to take place over https
538 * fixed two bugs that prevented proper recognition of xml character set
539 when it was declared inside the xml prologue
540 * added xmlrpc_client::setKey($key, $keypass) method, to allow using client
541 side certificates for https connections
542 * fixed bug that prevented proper serialization of string xmlrpcvals when
543 $xmlrpc_internalencoding was set to UTF-8
544 * fixed bug in xmlrpc_server::echoInput() (and marked method as deprecated)
545 * correctly set cookies/http headers into xmlrpcresp objects even when the
546 send() method call fails for some reason
547 * added a benchmark file in the testsuite directory
549 A couple of (private/protected) methods have been refactored, as well as a
550 couple of extra parameters added to some (private) functions - this has no
551 impact on the public API and should be of interest primarily to people extending
552 / subclassing the lib.
554 There is also new, PARTIAL support for the JSON-RPC protocol, implemented in
555 two files in the extras dir (more info about json-rpc at http://json-rpc.org)
558 XML-RPC for PHP version 2.0RC1 - 2005/10/03
560 I'm pleased to announce XML-RPC for PHP version 2.0, release candidate 1.
562 This release introduces so many new features it is almost impossible to list them
563 here, making the library finally on pair with, if not more advanced than, any other
564 similar offer (e.g. the PEAR XMLRPC package or the Incutio IXR library).
565 No, really, trust me.
567 The minimum supported PHP version is now 4.2 - natively - or 4.0.4pl1 - by usage of
568 a couple of compatibility classes (code taken from PEAR php_compat package).
570 The placement of files and directories in the distribution has been deeply modified,
571 in the hope of making it more clear, now that the file count has increased.
572 I hope you find it easy.
574 Support for "advanced" HTTP features such as cookies, proxies and keep-alives has
577 It is now much easier to convert between xmlrpcval objects and php values, and
578 in fact php_xmlrpc_encode and php_xmlrpc_decode are now the recommended methods
579 for all cases, except when encoding base64 data.
581 Two new (experimental) functions have been added, allowing automagic conversion
582 of a php function into an xmlrpc method to be exposed and vice-versa.
584 PHP objects can be now automatically serialized as xmlrpc struct values and
585 correctly deserialized on the other end of the transmission, provided that the
586 same class definition is present on both sides and no object members are of
589 A lot of the existing class methods have been overloaded with extra parameters
590 or new functionality, and a few added ex-novo, making usage easier than ever.
592 A complete debugger solution is included in the distribution. It needs a web server
593 to run (a freely available version of the same debugger is accessible online, it
594 can be found at http://phpxmlrpc.sourceforge.net).
596 For a more detailed list of changes, please read carefully chapter 2 of the
597 included documentation, or, even better, take a look at the source code, which
598 is commented in javadoc style quite a bit.
601 XML-RPC for PHP version 1.2 - 2005/08/14
603 This removes all use of eval(), which is a potential security problem.
604 All users are encouraged to upgrade as soon as possible.
605 As of this release we are no longer php3-compatible.
608 XML-RPC for PHP version 1.1.1 - 2005/06/30
610 This is a security vulnerability fix release.
611 All users are invited to upgrade as soon as possible.
614 XML-RPC for PHP version 1.1 - 2005/05/03
616 I'm pleased to announce XML-RPC for PHP version 1.1
617 It's taken two years to get to the this point, but here we are, finally.
619 This is a bugfix and maintenance release. No major new features have been added.
620 All known bugs have been ironed out, unless fixing would have meant breaking
622 The code has been tested with PHP 3, 4 and 5, even tough PHP 4 is the main
623 development platform (and some warnings will be emitted when running PHP5).
625 Noteworthy changes include:
627 * do not clash any more with the EPI xmlrpc extension bundled with PHP 4 and 5
628 * fixed the unicode/charset problems that have been plaguing the lib for years
629 * proper parsing of int and float values prepended with zeroes or the '+' char
630 * accept float values in exponential notation
631 * configurable http user-agent string
632 * use the same timeout on client socket reads as used for connecting
633 * more explicative error messages in xmlrpcresponse in many cases
634 * much more tolerant parsing of malformed http responses from xmlrpc servers
635 * fixed memleak that prevented the client to be used in never-ending scripts
636 * parse bigger xmlrpc messages without crashing (1MB in size or more)
637 * be tolerant to xmlrpc responses generated on public servers that add
638 javascript advertising at the end of hosted content
639 * the lib generates quite a few less PHP warnings during standard operation
641 This is the last release that will support PHP 3.
642 The next release will include better support for PHP 5 and (possibly) a slew of
645 The changelog is available at:
646 http://cvs.sourceforge.net/viewcvs.py/phpxmlrpc/xmlrpc/ChangeLog?view=markup
648 Please report bugs to the XML-RPC PHP mailing list or to the sourceforge project
649 pages at http://sourceforge.net/projects/phpxmlrpc/
652 XML-RPC for PHP version 1.0
654 I'm pleased to announce XML-RPC for PHP version 1.0 (final). It's taken
655 two years to get to the 1.0 point, but here we are, finally. The major change
656 is re-licensing with the BSD open source license, a move from the custom
657 license previously used.
659 After this release I expect to move the project to SourceForge and find
660 another primary maintainer for the code. More details will follow to the
663 It can be downloaded from http://xmlrpc.usefulinc.com/php.html
665 Comprehensive documentation is available in the distribution, but you
666 can also browse it at http://xmlrpc.usefulinc.com/doc/
668 Bugfixes in this release include:
670 * Small fixes and tidying up.
672 New features include:
674 * experimental support for SSL via the curl extensions to PHP. Needs
675 PHP 4.0.2 or greater, but not PHP 4.0.6 which has broken SSL support.
677 The changelog is available at: http://xmlrpc.usefulinc.com/ChangeLog.txt
679 Please report bugs to the XML-RPC PHP mailing list, of which more details are
680 available at http://xmlrpc.usefulinc.com/list.html, or to
681 <xmlrpc@usefulinc.com>.
684 XML-RPC for PHP version 1.0 beta 9
686 I'm pleased to announce XML-RPC for PHP version 1.0 beta 9. This is
687 is largely a bugfix release.
689 It can be downloaded from http://xmlrpc.usefulinc.com/php.html
691 Comprehensive documentation is available in the distribution, but you
692 can also browse it at http://xmlrpc.usefulinc.com/doc/
694 Bugfixes in this release include:
696 * Fixed string handling bug where characters between a </string>
697 and </value> tag were not ignored.
699 * Added in support for PHP's native boolean type.
701 New features include:
703 * new getval() method (experimental only) which has support for
704 recreating nested arrays.
705 * fledgling unit test suite
706 * server.php has support for basic interop test suite
708 The changelog is available at: http://xmlrpc.usefulinc.com/ChangeLog.txt
710 Please test this as hard as possible and report bugs to the XML-RPC PHP
711 mailing list, of which more details are available at
712 http://xmlrpc.usefulinc.com/list.html, or to <xmlrpc@usefulinc.com>.
715 XML-RPC for PHP version 1.0 beta 8
717 I'm pleased to announce XML-RPC for PHP version 1.0 beta 8.
719 This release fixes several bugs and adds a couple of new helper
720 functions. The most critical change in this release is that you can no
721 longer print debug info in comments inside a server method -- you must
722 now use the new xmlrpc_debugmsg() function.
724 It can be downloaded from http://xmlrpc.usefulinc.com/php.html
726 Comprehensive documentation is available in the distribution, but you
727 can also browse it at http://xmlrpc.usefulinc.com/doc/
729 Bugfixes in this release include:
731 * fixed whitespace handling in values
732 * correct sending of Content-length from the server
734 New features include:
736 * xmlrpc_debugmsg() method allows sending of debug info in comments in
737 the return payload from a server
739 * xmlrpc_encode() and xmlrpc_decode() translate between xmlrpcval
740 objects and PHP language arrays. They aren't suitable for all
741 datatypes, but can speed up coding in simple scenarios. Thanks to Dan
744 The changelog is available at: http://xmlrpc.usefulinc.com/ChangeLog.txt
746 Please test this as hard as possible and report bugs to the XML-RPC PHP
747 mailing list, of which more details are available at
748 http://xmlrpc.usefulinc.com/list.html, or to <xmlrpc@usefulinc.com>.
751 XML-RPC for PHP version 1.0 beta 7
753 I'm pleased to announce XML-RPC for PHP version 1.0 beta 7. This is
754 fixes some critical bugs that crept in. If it shows itself to be stable
755 then it'll become the 1.0 release.
757 It can be downloaded from http://xmlrpc.usefulinc.com/php.html
759 Comprehensive documentation is available in the distribution, but you
760 can also browse it at http://xmlrpc.usefulinc.com/doc/
762 Bugfixes in this release include:
764 * Passing of booleans should now work as expected
765 * Dollar signs and backslashes in strings should pass OK
766 * addScalar() now works properly to append to array vals
768 New features include:
770 * Added support for HTTP Basic authorization through the
771 xmlrpc_client::setCredentials method.
773 * Added test script and method for verifying correct passing of
776 The changelog is available at: http://xmlrpc.usefulinc.com/ChangeLog.txt
778 Please test this as hard as possible and report bugs to the XML-RPC PHP
779 mailing list, of which more details are available at
780 http://xmlrpc.usefulinc.com/list.html, or to <xmlrpc@usefulinc.com>.
783 XML-RPC for PHP version 1.0 beta 6
785 I'm pleased to announce XML-RPC for PHP version 1.0 beta 6. This is the
786 final beta before the 1.0 release.
788 It can be downloaded from http://xmlrpc.usefulinc.com/php.html
790 Comprehensive documentation is available in the distribution, but you
791 can also browse it at http://xmlrpc.usefulinc.com/doc/
793 New features in this release include:
795 * Perl and Python test programs for the demo server
796 * Proper fault generation on a non-"200 OK" response from a remote host
797 * Bugfixed base64 decoding
798 * ISO8601 helper routines for translation to and from UNIX timestamps
799 * reorganization of code to allow eventual integration of alternative
802 The changelog is available at: http://xmlrpc.usefulinc.com/ChangeLog.txt
804 Please test this as hard as possible and report bugs to the XML-RPC PHP
805 mailing list, of which more details are available at
806 http://xmlrpc.usefulinc.com/list.html, or to <xmlrpc@usefulinc.com>.