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