Merge pull request #51 from FinesseRus/patch-1
[plcapi.git] / ChangeLog
1 NB: All recent commits are available online.
2 This file will not be updated further.
3 See https://github.com/gggeek/phpxmlrpc/commits/master
4
5 2014-05-26 - G. Giunta (giunta.gaetano@gmail.com)
6
7         * removed bundled phpunit
8         * converted all tabs to spaces in php files and removed closing tags
9
10 2014-05-12 - Samu Voutilainen (smar@smar.fi)
11
12         * removed obsolete xml.so open; dl() is deprecated and removed from 5.3.0
13         * removed deprecated xmlEntities
14         * removed deprecated xmlrpc_backslash
15         * converted $GLOBALS to internal class. This makes testing much easier and should be more flexible regarding other projects
16         * changed verifyhost from 1 to 2. This makes modern php versions work properly.
17         * split off each class in its own file
18
19 2014-02-03 - G. Giunta (giunta.gaetano@gmail.com)
20
21         * bumped up requirements to php 5.1.0
22
23 2014-01-10 - G. Giunta (giunta.gaetano@gmail.com)
24
25         * xmlrpc.inc: when using curl and keepalive, reset curl handle if we did not get back an http 200 response (eg a 302)
26
27         * testsuite.php, parse_args.php: update testsuite
28
29         * debugger/controller.php: change default path to javascript debugger
30
31 2010-05-23 - G. Giunta (giunta.gaetano@gmail.com)
32
33         * xmlrpc.inc: omit port on http 'Host' header if it is 80;
34         add a namespace declaration in response if ex:nil is in use
35
36 2010-04-12 - G. Giunta (giunta.gaetano@gmail.com)
37
38         * testsuite.php, parse_args.php: testsuite allows interrogating https servers ignoring their certs
39
40         * xmlrpc.inc: method setAcceptedCompression was failing to disable reception
41         of compressed responses if the client supported them (triggering a bug with
42         https and php < 5.3 on windows); remove a php warning that could be
43         generated when using debug=2 in a client connecting to an https
44         server
45
46 2010-04-11 - G. Giunta (giunta.gaetano@gmail.com) thanks amoe
47
48         * fixed: bad variables in "make install" make target
49
50 2009-11-11 - G. Giunta (giunta.gaetano@gmail.com) thanks Ikiro Watanabe
51
52         * added INSTALL file
53
54 2009-09-05 - G. Giunta (giunta.gaetano@gmail.com)
55
56         * xmlrpcs.inc, xmlrpcs.inc: remove code that was left for compatibility
57         with php 4; use __METHOD__ constant for error messages instead of hardcoded
58         values
59
60         * xmlrpcs.inc: catch exceptions thrown during execution of invoked methods;
61         check for $_SERVER having been disabled via php.ini and log an error if so
62
63         * server.php, testsuite.php: add a new test and server method for exception
64         catching in the server
65
66         * xmlrpc.inc: added new method SetUserAgent to client to allow having different
67         user-agent http headers
68
69         * tagged and released as 3.0.0 beta
70
71 2009-08-05 - G. Giunta (giunta.gaetano@gmail.com)
72
73         * xmlrpc_wrappers.inc: improve compatibility with php 5.0 when registering
74         class/object methods
75
76 2009-08-02 - G. Giunta (giunta.gaetano@gmail.com) thanks Laurens
77
78         * xmlrpcs.inc: add a new member var in server class to allow fine-tuning
79         of the encoding of returned values when the server is in 'phpvals' mode;
80         allow servers in 'xmlrpcvals' mode to also register plain php functions by
81         defining them in the dispatch map with an added option:
82         'parameters_type' => 'phpvals' (feature request #2806628)
83
84         * xmlrpc.inc: added new method xmrlpc_client::SetCurlOptions($array) to
85         allow extra flexibility in tweaking http config, such as explicitly
86         binding to an ip address (feature request #2787468); fix bad encoding if
87         same object is encoded twice using php_xmlrpc_encode; removed some by-ref
88         assignments and declarations
89
90 2009-07-31 - G. Giunta (giunta.gaetano@gmail.com)
91
92         * xmlrpc.inc: add support for dateTime objects in both in php_xmlrpc_encode
93         and as parameter for constructor of xmlrpcvals; add support for timestamps
94         as parameter for constructor of xmlrpcvals; add option 'dates_as_objects' to
95         php_xmlrpc_decode to return dateTime objects for xmlrpc datetimes
96
97         * benchmark.php, xmlrpc_wrappers.inc: remove usage of split(), deprecated in
98         php 5.3
99
100         * benchmark.php: fixed url of server page used for testing; improved
101         verification of correspondence of test results; added more variants for
102         http options comparison
103
104         * verify_compat.php: check for php version 5 for client side too
105
106         * makefile: remove from build the compat directory
107
108 2009-07-26 - G. Giunta (giunta.gaetano@gmail.com)
109
110         * server.php: remove usage of ereg*(), deprecated in php 5.3
111
112 2009-07-16 - G. Giunta (giunta.gaetano@gmail.com) thanks Jean-Jacques Sarton
113
114         * xmlrpc.inc: add support for the <ex:nil/> from the apache library, both
115         in input and output (feature request #...)
116
117         * xmlrpc.inc, testsuite.php: remove usage of split(), deprecated in php 5.3
118
119         * testsuite.php: flush better results with output_buffering on
120
121         * server: php: avoid one warning about static function calls
122
123 2009-07-02 - G. Giunta (giunta.gaetano@gmail.com) thanks Heiko Stuebner
124
125         * xmlrpc.inc: fix: when checking the parameters against the signatures xmlrpc
126         checks for "array" but PHP returns "Array" resulting in a not matches signature
127
128 2009-05-07 - G. Giunta (giunta.gaetano@gmail.com)
129
130         * replace all usage of '= & new' with '= new', as this is deprecated in php 5
131         and has been shown to cause problems too
132
133 2009-05-06 - G. Giunta (giunta.gaetano@gmail.com)
134
135         * create php4 branch, rename trunk to 3.0.0beta - it will be the php5-only version
136
137         * xmlrpc.inc: removed test for php version and inclusion of compat patches for really
138         really old versions of php 4
139
140 2009-03-16 - G. Giunta (giunta.gaetano@gmail.com) thanks Tommaso Trani
141
142         * move from CVS to SVN on sf.net; file layout now is the same as in packaged lib
143
144         * xmlrpc.inc: fix php warning when receiving 'false' in a bool value
145
146         * Makefile, doc/Makefile: alter to follow new file layout
147
148         * tagged and released as 2.2.2
149
150 2009-02-03 - G. Giunta (giunta.gaetano@gmail.com)
151
152         * debugger/action.php: improve code robustness when parsing system.listmethods
153         and system.describemethods call
154
155         * xmlrpc.inc: format floating point values using the correct decimal separator
156         even when php locale is set to one that uses comma (bug #2517579);
157         use feof() to test if socket connections are to be closed instead of the
158         number of bytes read (bug #2556209)
159
160 2008-10-29 - G. Giunta (giunta.gaetano@gmail.com)
161
162         * xmlrpcs.inc: allow add_to_map server method to add docs for single params, too
163
164 2008-09-20 - G. Giunta (giunta.gaetano@gmail.com)
165
166         * xmlrpc_wrappers.inc: added the possibility to wrap for exposure as xmlrpc
167         methods plain php class methods, object methods and even whole classes
168
169         * testsuite.php, server.php: added test cases for the new code
170
171 2008-09-07 - G. Giunta (giunta.gaetano@gmail.com) thanks Bruno Zanetti Melotti
172
173         * xmlrpc.inc: be more tolerant in detection of charset in http headers (fix for bug #2058158)
174
175 2008-04-05 - G. Giunta (giunta.gaetano@gmail.com)
176
177         * xmlrpc.inc: fix encoding of UTF8 chars outside of the BMP
178
179         * xmlrpcs.inc: fix detection of zlib.output_compression (thanks xbert)
180
181 2008-03-06 - G. Giunta (giunta.gaetano@gmail.com)
182
183         * tagged and released as 2.2.1
184
185         * Makefile: improve usage on windows xp despite cmd's broken mkdir
186
187 2007-10-26 - G. Giunta (giunta.gaetano@gmail.com) thanks sajo_raftman
188
189         * xmlrpc.inc: remove one warning in xmlrpc_client creator
190
191 2007-10-26 - G. Giunta (giunta.gaetano@gmail.com)
192
193         * xmlrpc.inc: improve support for windows cp1252 character set (still
194         commented in the code)
195
196 2007-09-05 - G. Giunta (giunta.gaetano@gmail.com)
197
198         * xmlrpc.inc, xmlrps.inc: do not try to set invalid charsets as output for
199         xml parser, even if user set them up for internal_encoding (helps encoding
200         to exotic charsets, while decoding to UTF8)
201
202 2007-09-05 - G. Giunta (giunta.gaetano@gmail.com)
203
204         * xmlrpc.inc: fix parsing of '1e+1' as valid float
205
206 2007-09-01 - G. Giunta (giunta.gaetano@gmail.com), thanks Frederic Lecointre
207
208         * xmlrpcs.inc: allow errorlevel 3 to work when prev. error handler was a static method
209
210         * testsuite.php: fix test on setCookie()
211
212 2007-08-31 - G. Giunta (giunta.gaetano@gmail.com)
213
214         * xmlrpc.inc: minor fix in cookie parsing
215
216 2007-07-31 - G. Giunta (giunta.gaetano@gmail.com)
217
218         * xmlrpc.inc: Fix usage of client::setcookie() for multiple cookies in non-ssl mode
219
220 2007-07-26 - G. Giunta (giunta.gaetano@gmail.com) thanks Mark Olive
221
222         * xmlrpc.inc: Fix for bug # 1756274 (usage of cookies in ssl mode)
223
224 2007-04-28 - G. Giunta (giunta.gaetano@gmail.com)
225
226         * xmlrpc.inc: give more detailed curl information when DEBUG = 2; fix handling
227         of case where curl w. keepalive is used and one connection of many fails
228
229         * testsuite improvements: add one testcase; give feedbcak while tests are
230         running
231
232 2007-04-01 - G. Giunta (giunta.gaetano@gmail.com)
233
234         * doc/makefile, doc/custom.fo.xsl: improve pdf rendering of php source code
235
236         * makefile: recover version number from source instead of having it hardcoded
237
238 2007-03-10 - G. Giunta (giunta.gaetano@gmail.com)
239
240         * doc/makefile, doc/convert.php, doc/*.xsl: created customizations xslt to
241         produce a documentation more in line with the php manual, esp. with regards
242         to functions synopsis; added jellyfish book cover as local resource and a
243         screenshot of the debugger too; various updates to the manual source; added
244         a php script to highlight examples inside html docs
245
246 2007-03-09 - G. Giunta (giunta.gaetano@gmail.com)
247
248         * debugger/action.php: css tweak for IE
249
250         * added phpunit license file in the phpunit directory
251
252         * added link to license (on sf.net site) to many files
253
254 2007-03-04 - G. Giunta (giunta.gaetano@gmail.com)
255
256         * Makefile, doc/makefile: assorted improvements
257
258 2007-03-03 - G. Giunta (giunta.gaetano@gmail.com)
259
260         * xmlrpc.inc: micro-optimization in declaration of global vars xmlrpcerr, xmlrpcstr
261
262 2007-02-25 Gaetano Giunta <giunta.gaetano@gmail.com>
263
264         * removed a couple of warnings emitted in testsuite.php
265
266         * doc/makefile: added command for invocation of xxe to generate docs
267
268         * better rendering of docs in xml+css format for function prototypes
269
270         * updated documentation
271
272         * tagged and released as 2.2
273
274 2007-02-22 Gaetano Giunta <giunta.gaetano@gmail.com>
275
276         * debugger: workaround for case of magic_quotes_gpc being set (properly
277         unescape user input); fix case of user not setting msg id in jsonrpc case
278         when executing a remote method; allow strings, false, true and null as msg id
279
280 2007-02-13 Gaetano Giunta <giunta.gaetano@gmail.com>
281
282         * testsuite.php: added one test for automatic encoding/decoding case
283
284 2007-02-05 Gaetano Giunta <giunta.gaetano@gmail.com>
285
286         * xmlrpc.inc: slightly faster encoding of UTF8 data to ascii
287
288 2007-01-11 Gaetano Giunta <giunta.gaetano@gmail.com>
289
290         * xmlrpc.inc: when calling client::multicall() with an unspecified http version,
291         use the client default rather than the fixed 'http 1.0'
292
293 2006-09-17 Gaetano Giunta <giunta.gaetano@gmail.com>
294
295         * xmlrpc.inc, xmlrpcs.inc, testsuite.php: added support for <NIL/> and
296         system.getCapabilities, and one more testcase to go with it
297
298 2006-09-05 Gaetano Giunta <giunta.gaetano@gmail.com>
299
300         * xmlrpc.inc: fix support for https through proxies; client parses debug
301         messages sent by client even for compressed responses;
302
303         * testsuite.php, parse_args.php: added 3 test cases for proxy connections
304
305 2006-09-01 Gaetano Giunta <giunta.gaetano@gmail.com>
306
307         xmlrpc_wrappers.inc: add two more options in wrap_xmlrpc_method and fix
308         typo to allow obj encoding
309
310 2006-08-28 Gaetano Giunta <giunta.gaetano@gmail.com>
311
312         * xmlrpc_wrappers.inc: more options added to wrap_php_function and
313         wrap_xmlrpc_method
314
315         * xmlrpc.inc: pave the way to support for <nil/>
316
317         * doc/xmlrpc_php.xml documentation updated
318
319         * tagged and released as 2.1
320
321 2006-08-25 Gaetano Giunta <giunta.gaetano@gmail.com>
322
323         * xmlrpc.inc: stricter parsing of incoming messages: detect two DATA elements
324         inside an ARRAY, a STRUCT or SCALAR inside an already filled VALUE
325
326         * testsuite.php: added two testcases to check for the above cases
327
328 2006-08-24 Gaetano Giunta <giunta.gaetano@gmail.com>
329
330         * xmlrpc.inc: more code optimization in xmlrpcval::serialize() and
331         php_xmlrpc_encode(); fixed bug where struct elements with non-ascii chars
332         in their name would not be properly encoded
333
334         * testsuite.php: added a testcase for the new bug
335
336 2006-08-23 Gaetano Giunta <giunta.gaetano@gmail.com>
337
338         * remove old code left in comments across many files; many more javadoc
339         comments added
340
341         * xmlrpc.inc: a bit of code optimization: reorder switch() statements of
342         xml parsing element handlers; inline code for xmlrpcval() - this breaks
343         new xmlrpcval('true') and changes error msgs on new xmlrpcval($x, 'invalid_type')
344
345         * testsuite.php: change according to above
346
347         * benchmark.php: basic support for xdebug 2 profiling
348
349 2006-08-22 Gaetano Giunta <giunta.gaetano@gmail.com>
350
351         * xmlrpc.inc: addscalar() and addstruct() where not returning 1 when adding
352         data to an already formed value
353
354 2006-08-21 Gaetano Giunta <giunta.gaetano@gmail.com>
355
356         * xmlrpcs.inc, xmlrpc.inc: added support for emulating the xmlrpc-extension
357         API (the full emulation layer is part of the extras package);
358         fix support for the HTTP 'deflate' encoding
359
360         * xmlrpc.inc: better support for http compression with and without CURL;
361         a minor decoding speedup; added a new function: php_xmlrpc_decode_xml(),
362         that will convert into the appropriate object the xml representation of
363         either a request, response or a single value; log reception of invalid
364         datetime values
365
366         * xmlrpcs.inc: add a new parameter and return type to server->service();
367         let server->add_to_map() accept method definitions without parameter types
368
369         * xmlrpc_wrappers.inc: more logging of errors; wrap_php_functions now takes
370         more options; better support for jsonrpc; escape quote chars when wrapping
371         remothe servers / remote methods
372
373         * added cvs Id tag to files that missed it; speling fixes; updated NEWS files
374
375 2006-08-07 Gaetano Giunta <giunta.gaetano@gmail.com>
376
377         * assorted fixes to make the suite more compatible with php 4.0.5 and 5.x
378
379 2006-07-02 Gaetano Giunta <giunta.gaetano@gmail.com>
380
381         * xmlrpc_warppers.inc: added new function to wrap entire remote server into
382         a local php class; changed default calling synopsis of wrap_remote_method,
383         to ease passing multiple options at a time (but old syntax still works!)
384
385         * updated makefile, debugger/action.php in accord with the above
386
387 2006-06-30 Gaetano Giunta <giunta.gaetano@gmail.com>
388
389         * added to debugger capability to generate json-rpc code stubs
390
391         * added to debugger capability to load and launch self correctly if
392         controller.php is called directly from outside processes (single url access)
393
394 2006-06-26 Gaetano Giunta <giunta.gaetano@gmail.com>
395
396         * moved wrap_php_functions and wrap_xmlrpc_method into a file of their own.
397         This will let us add further stub functionality without the base lib growing too much.
398         All of the files that reference this functionality have been modified accordingly.
399
400         * made wrap_xmlrpc_method generate better code (with php type juggling), and
401         some phpdoc for the generated function, too
402
403         * added to debugger an option to produce for the user the generated php code
404         for wrapping a call to a remote method into a php function
405
406 2006-06-22 Gaetano Giunta <giunta.gaetano@gmail.com>
407
408         * xmlrpcs.inc: added description of parameters for system.xxx methods (useful with
409         html-self-documenting servers);
410         server->service() now returns response object, in case user has need for it...
411
412         * xmlrpc.inc: save full response payload into xmlrpcresp obj for better debugging
413
414 2006-06-15 Gaetano Giunta <giunta.gaetano@gmail.com>
415
416         * verify_compat.php: more tests
417
418 2006-06-09 Gaetano Giunta <giunta.gaetano@gmail.com>
419
420         * xmlrpcs.inc: fixed sending of compressed responses when output compression
421         is already enabled in php.ini
422
423         * verify_compat.php: split tests between server and client cases
424
425 2006-05-29  Gaetano Giunta <giunta.gaetano@gmail.com>
426
427         * added new file: verify_compat.php, to help troubleshooting platform
428         support for the library; added it to makefile, too
429
430 2006-05-24  Gaetano Giunta <giunta.gaetano@gmail.com>
431
432         * xmlrpc.inc: removed residual usage of regexp in favour of  pregexps; fixed
433         a bug in specifying Host http header with non std ports
434
435 2006-05-23  Gaetano Giunta <giunta.gaetano@gmail.com>
436
437         * xmlrpc.inc: improvements to wrap_php_function: let it deal correctly
438         with php functions returning xmlrpcresp objs; make it generate also
439         docs for single parameters (useful for documenting_xmlrpc_server class)
440
441 2006-05-22  Gaetano Giunta <giunta.gaetano@gmail.com>
442
443         * xmlrpc.inc, xmlrpcs.inc: minor performance tuning updates: replaced
444         some explode vs. split, ereg vs. preg, single vs. double quotes
445
446         * xmlrpc.inc: fix wrap_xmlrpc_method to NOT rebuild php objects received
447         from the server by default, as it might pose a security risk
448
449 2006-04-24  Gaetano Giunta <giunta.gaetano@gmail.com>
450
451         * minor fixes makefiles. Tagged and released as 2.0 final
452
453 2006-04-22  Gaetano Giunta <giunta.gaetano@gmail.com>
454
455         * debugger/*: added option to set cainfo; improve web layout
456
457         * xmlrpc.inc: set sslverifypeer to TRUE instaed of 1 by default
458
459         * doc/php_xmlrpc.xml: documentation updates
460
461 2006-04-21  Gaetano Giunta <giunta.gaetano@gmail.com>
462
463         * xmlrpc.inc: added option to set ca certs dir instead of single cert
464         (used to validate server in https connetions)
465
466 2006-04-18  Gaetano Giunta <giunta.gaetano@gmail.com>
467
468         * xmlrpc.inc: fixed bug in xmlrpcval::structmemexists()
469
470         * testsuite.php: added test case for xmlrpcval::structmemexists()
471
472 2006-04-03  Gaetano Giunta <giunta.gaetano@gmail.com>
473
474         * xmlrpc.inc: add support for Digest and NTLM authentication, both to server
475         and to proxies (note: must use CURL for this to work)
476
477         * debugger/*: add support for Digest/NTLM auth to remote servers
478
479 2006-03-19  Gaetano Giunta <giunta.gaetano@gmail.com>
480
481         * xmlrpc.inc: fix a bug parsing of 'true' bool values;
482         added a new method to the client class: SetCaCertificate;
483         add column number in xml parsing error messages;
484         fix serialization of messages to ISO-8859-1 charset with php 5 (by adding
485         encoding to the xml prologue of generated messages)
486
487         * xmlrpcs.inc: correct detection of charset in http headers;
488         add column number in xml parsing error messages;
489         fix serialization of responses to ISO-8859-1 charset with php 5 (by adding
490         encoding to the xml prologue of generated responses)
491
492         * testsuite.php: added two more tests on charset encoding
493
494         * NEWS: update info for impending release
495
496 2006-03-23  Gaetano Giunta <giunta.gaetano@gmail.com>
497
498         * added a new demo file: simple_call.php
499
500 2006-02-20  Gaetano Giunta <giunta.gaetano@gmail.com>
501
502         * xmlrpcs.inc: more error checking and logging with regard to user-coded
503         method handler functions not being well behaved;
504         fix a case where error handler would not be reset upon user function
505         returning not valid xmlrpresp
506
507         * xmlrpc.inc: fix bug in detection of php 4.3.0
508
509         * Makefile: fix uppercase filenames
510
511 2006-02-15
512
513         * xmlrpc.inc: parse 'true' and 'false' as valid booleans, even though the
514         spec is quite clear on that; fix small bug w. internal_encoding = utf8; add
515         definition of $GLOBALS['xmlrpcNull'] for extensibility, e.g. json or
516         extensions to the xmlrpc spec
517
518 2006-02-05  Gaetano Giunta <giunta.gaetano@gmail.com>
519
520         * xmlrpc.inc: fix bug in wrap_xmlrpc_method if client passed to function has
521         return_type=phpvals
522
523         * all demo files: review code, add more comments and information
524
525         * added 2 demo files: proxy.php (implementing an xmlrpc proxy server) and
526         wrap.php (showing usage of wrap_method_call)
527
528 2006-02-04  Gaetano Giunta <giunta.gaetano@gmail.com>
529
530         * xmlrpc.inc: fix bug in multicall in case of no fallback and server error
531
532 2006-01-30  Gaetano Giunta <giunta.gaetano@gmail.com>
533
534         * xmlrpc.inc: fix recursive serialization of xmlrpcvals loosing UTF8 charset;
535         correctly set type field of xmlrpcvals returned by send() calls
536
537         * xmlrpcs.inc: add to server checks for correct return type of user-coded
538         method handling function; tolerate xmlrpcval instead of xmlrpcresp
539
540         * minor change in xmlrpcresp internals, to ease subclassing (store payload
541         in an internal var on serialize(), same as xmlrpcclient does)
542
543 2006-01-22  Gaetano Giunta <giunta.gaetano@gmail.com>
544
545         * benchmark.php: do not run http 1.1 tests if CURL notfound
546
547         * Released as 2.0 Rc3
548
549 2006-01-19  Gaetano Giunta <giunta.gaetano@gmail.com>
550
551         * xmlrpc.inc: make xmlrpc_client::setDebug() accept int values instead of
552         boolean. At level 2, the request payload is printed to screen before being
553         sent; fix bug with repeated sending of the same msg object and using request
554         compression w. php 5.1.2 (objects passed by ref by default!!!)
555
556         * xmlrpcs.inc: fix detection of clients accepting compressed responses
557
558         * comment.php: remove warnings due to liberal usage of $HTTP_POST/GET_VARS
559
560         * benchmark.php: add a test using http compression of both requests and
561         responses
562
563         * testsuite.php: added test for fix in xmlrpc.inc
564
565 2006-01-17  Gaetano Giunta <giunta.gaetano@gmail.com>
566
567         * xmlrpcs.php: minor fix: do not raise a PHP warning when std server is
568         called via GET (global HTTP_RAW_POST_DATA undefined). Some might have called
569         it a security breach (path disclosure)...
570
571 2006-01-15  Gaetano Giunta <giunta.gaetano@gmail.com>
572
573         * testsuite.php: minor fix to expected date format in http cookie hedaer
574         to cope with PHP 5.1.2
575
576 2006-01-05  Gaetano Giunta <giunta.gaetano@gmail.com>
577
578         * xmlrpcs.inc: merge code from the 'extras' subclass that allows server
579         to register plain php functions in dispatch map instead of functions
580         accepting a single xmlrpcmgs obj parameter.
581         One step closer to the kitchen sink!!!
582
583 2005-12-31  Gaetano Giunta <giunta.gaetano@gmail.com>
584
585         * xmlrpcs.inc: let the server accept 'class::method' syntax in the dispatch
586         map
587
588         * testsuite.php, server.php: added new tests for the recent charset encoding
589         capabilities
590
591 2005-12-24  Gaetano Giunta <giunta.gaetano@gmail.com>
592
593         * xmlrpc.inc: correctly serialize() string xmlrpcvals that have been
594         created out of non-string php variables, when internal encoding is UTF8;
595         serialize to '0' int and double values created out of non-string php
596         variables, eg. 'hello', instead of creating invalid xmlrpc;
597         extend the php_xmlrpc_encode function to allow serializing string values
598         to charsets other tha US-ASCII;
599         minor tweak to xml parsing to allow correct parsing of empty strings when
600         in 'direct to php values' mode
601
602         * xmlrpcs.inc: advances in system.multicall with plain php values
603
604 2005-12-17  Gaetano Giunta <giunta.gaetano@gmail.com>
605
606         * xmlrpcs.inc: let the functions implementing the system.* methods work
607         fine when called with plain php values as parameters instead of xmlrpcmsg
608         objects (multicall not quite finished yet...);
609         encode level 3 debug info as base64 data, to avoid charset encoding hell
610
611         * xmlrpc.inc: added a new xmlrpc_2_php_type function, to get the name of
612         php types corresponding to xmlrpc types;
613         in debug mode, when detecting base64 server debug info, print it out fine
614
615         * server.php: cosmetic fixes
616
617 2005-12-09  Gaetano Giunta <giunta.gaetano@gmail.com>
618
619         * xmlrpc.inc: remove one warning emitted when received xml contains an
620         unknown tag; remove warnings emitted when custom error handler is set
621         and user calls php_xmlrpc_encode/decode without the 2nd parameter
622
623         * xmlrpcs.inc: added a param to service(), to allow the server to parse
624         data other than the POST body (useful for subclassing and debugging);
625         reworked the implementation of server debug messages at debug level 2:
626         since the debug info generated has no known charset, and putting it back
627         into the response's xml would most likely break it, send it back to the
628         client as a base64 encoded comment. Clients can decode it if they need it...
629         Add some more javadocs
630
631         * testsuite.php: modified the string test, to see if the server can echo
632         back to the client the received data without breaking the response's xml
633
634 2005-12-05  Gaetano Giunta <giunta.gaetano@gmail.com>
635
636         * xmlrpc.inc, xmlrpcs.inc: let server and client objects decide if they
637         want to use some charset encoding other than US-ASCII for serialized data:
638         add a new var to both objects, and lots of parameters to function calls
639         that took none up to now;
640         refactored server method service() and parseRequest(), implementing a
641         new parserequestHeaders() method to explicitly deal with HTTP
642
643 2005-12-01  Gaetano Giunta <giunta.gaetano@gmail.com>
644
645         * moved the jsonrpc implementation and the new wsdl stuff to a separate
646         CVS module; updated the makefile to reflect it
647
648 2005-11-24  Gaetano Giunta <giunta.gaetano@gmail.com>
649
650         * modified php_xmlrpc_decode() to work on xmlrpcmessages too, besides
651         xmlrpcvals. To achieve this, added a new method: xmlrpcmsg::kindOf()
652
653 2005-11-22  Gaetano Giunta <giunta.gaetano@gmail.com>
654
655         * released as 2.0 RC2
656
657 2005-11-21  Gaetano Giunta <giunta.gaetano@gmail.com>
658
659         * xmlrpc.inc: fix warnings about references for PHP 4.1.X
660
661         * Whitespace cleanup on all the lib
662
663 2005-11-16  Gaetano Giunta <giunta.gaetano@gmail.com>
664
665         * xmlrpc.inc: rewritten xmlrpc_encode_entitites adding two extra parameters
666         that specify input and output charset encodings. This corrects the bug that
667         prevented native UTF-8 strings to be correctly serialized (to have them
668         encoded the user must set $xmlrpc_internalencoing appropriately).
669
670         * xmlrpc.inc: added new method xmlrpcmsg::parseResponseHeaders(), refactoring
671         parseResponse(). This makes the code more modular and eases subclassing.
672
673         * xmlrpc.inc: set cookies and http headers to xmlrpcresp objs even when calls
674         to send() do not complete correctly
675
676         * added new file: jsonrpcs.inc, to accomodate server jsonrpc objects in the future
677
678         * jsonrpc.inc: slow progress...
679
680 2005-11-10  Gaetano Giunta <giunta.gaetano@gmail.com>
681
682         * xmlrpc.inc: fixed the xmlrpc_client send and sendpayloadhttps methods
683         to fix errors in calling https servers;
684         added a new xmlrpc_client->setkey method to allow usage of client-side ssl
685         certs in recent php builds;
686         added to xmlrpcresp objects a content_type var, to be used in HTTP headers
687
688         * xmlrpcs.inc: separate generation of content-type http header and xml prologue
689         from the service() method, to ease subclassing
690
691 2005-11-03  Gaetano Giunta <giunta.gaetano@gmail.com>
692
693         * xmlrpc.inc: moved the 'text/xml' mimetype string as class var of the xmlrpcmsg
694         object instead of having it cabled into xmlrpc_client->send(): this allows to
695         create subclasses of xmlrpcmsg that use a different mimetype
696
697         * jsonrpc.inc: added a new file, with an extremely experimental set of classes,
698          designed to implement a json-rpc client and server, taking advantage of the
699          existing xml-rpc infrastructure
700
701 2005-10-28  Gaetano Giunta <giunta.gaetano@gmail.com>
702
703         * xmlrpc.inc: changed constructor method for xmlrpcresp, making it smarter in
704         case user does not declare the type of value it is passing to it;
705         minor changes in serialization of xmlrpcresp with error codes, so that it
706         utputs LF instead of CRLF on windows boxes after an FTP transfer of the code, too
707
708 2005-10-26  Gaetano Giunta <giunta.gaetano@gmail.com>
709
710         * xmlrpc.inc: added a new var of class xmlrpc_client, indicating what kind of
711         object will be stored in the value() of xmlrpcresp's gotten from the send()
712         method: xmlrpxc objects, plain php variables or raw xml. This allow the coder
713         to make use of xmlrpc_decode for better performances if he wishes so.
714         Modified creator of xmlrpcresp class to allow it to distinguish between being
715         created out of raw xml or a plain php string (in the former case, serialization
716         is still possible, opening a new world of opportunity for server-side programming:
717         the php function implementing a web service has to provide the xml for the
718         return value on its own).
719         Modified xmlrpc_client::multicall() to suit; also added a new parameter which
720         allows calls to multicall without automatic fallback to many-calls in case of
721         error (speeding up the process of doing a failed multicall() call quite a bit)
722         Fixed two bugs in guess_encoding.
723         Audited all regexps and fixed some.
724         xmlrpc_client::send() does not call xmlrpcmsg::parseresponsefile() anymore.
725         Shuffled parseresponse() a little bit
726
727         * testsuite.php: added a new testcase for the modifications to multicall():
728         now we test the case where xmlrpc_client returns php values, too
729
730 2005-10-24  Gaetano Giunta <giunta.gaetano@gmail.com>
731
732         * xmlrpc.inc: fixed guess_encoding() to always return uppercase chars
733
734         * added new file: benchmark.php. It contains a few tests used to evaluate
735         speed of the lib in common use cases
736
737         * added file parse_args.php, containing common code for benchmark and
738         testsuite, and modified testsuite.php accordingly
739
740         * modified makefile adding new files
741
742         * testsuite.php: added a couple of new test cases; fixed one warning
743         emitted in php 5 E_STRICT mode
744
745 2005-10-20  Gaetano Giunta <giunta.gaetano@gmail.com>
746
747         * xmlrpc.inc: modify 3d param of ParseResponse(), allowing the function to
748         return the raw xml received as value of the xmlrpcresponse object.
749         This allows eg. to have epi-xmlrpc decode the xml for faster execution.
750
751 2005-10-09  Gaetano Giunta <giunta.gaetano@gmail.com>
752
753         * xmlrpc.inc: fixed error that prevented usage of HTTPS (the client
754         always determined that ssl support was not present)
755
756 2005-10-03  Gaetano Giunta <giunta.gaetano@gmail.com>
757
758         * xmlrpc.inc, xmlrpcs.inc: revert direction of stack growth during xml
759         parsing for faster execution time; add support for detecting charset
760         encoding of received xml; add support for cookies; better parsing of
761         javadoc when building stub code in wrap_php_function; add a lot of
762         javadoc comments everywhere; rewrite most error messages
763
764         * testsuite.php: add many tests for newly introduced features
765
766         * server.php: add a couple of new functions to support debugging new
767         features
768
769         * debugger: add switches to enable all the latest lib features; minor
770         improvements to layout
771
772         * synch included phpunit with latest PEAR release
773
774         * reorganize files included in the distribution in a new hierarchy of folders
775
776         * bump revision number to 2.0RC1 and release
777
778 2005-8-14  Miles Lott <milos@groupwhere.org>
779
780         * xmlrpc.inc, xmlrpcs.inc: Remove all use of eval() to avoid potential
781         security hole.
782
783         * As of this release we are no longer php3-compatible.
784
785 2005-8-10 Miles Lott <milos@groupwhere.org>
786
787         * xmlrpc.inc, xmlrpcs.inc: Switched to using $GLOBALS instead of calling
788         global $varname
789
790 2005-07-22  Miles Lott <milos@groupwhere.org>
791
792         * Removed: bug_* files
793
794 2005-07-14  Gaetano Giunta <giunta.gaetano@gmail.com>
795
796         * debugger: added a workaround to disable using the debugger for attacking
797         older versions of the lib
798
799         * testsuite.php: added code to test wrap_xmlrpc_method;
800         use different wording for failed tests
801
802         * xmlrpcs.inc: change for() with foreach() in system.* methods implementations;
803         remove a possible cause of php warning;
804
805         * xmlrpc.inc: let wrap_php_function and wrap_xmlrpc_method find suitable
806         function names if default function names are already in use;
807         correct wrap_xmlrpc_method to not set http protocol to 1.0 when not asked to;
808         detect curl compiles without SSL
809
810 2005-07-14  Gaetano Giunta <giunta.gaetano@gmail.com>
811
812         * xmlrpc.inc: more auto-fix of xmlrpc_client path: '' -> '/';
813         change to the method used for detecting failed evals (php 4.0.x compatibility);
814         complete rework of return-by-ref functions to comply with php 4.4.0
815
816         * xmlrpcs.inc: change to the method used for detecting failed evals (php 4.0.x
817         compatibility)
818
819         * testsuite.php: major rewrite of the multi- tests, to give better feedback on
820         number of failed tests;
821         flush html page title to screen before starting tests;
822
823 2005-07-13  Gaetano Giunta <giunta.gaetano@gmail.com>
824
825         * xmlrpc.inc: let xmlrpcmsg creator be forgiving of target paths that miss the
826         starting '/' char;
827         completely reworked assign-by-ref to be compliant with php 4.4.0 stricter
828         warnings
829
830         * testsuite.php: added ability to be run from cli: (really dumb) separation of
831         html and plain text outputs + parsing of argv parameters
832
833 2005-07-12  Gaetano Giunta <giunta.gaetano@gmail.com>
834
835         * xmlrpc.inc: compatibility fixes with PHP versions 4.0.x (and remove some for
836         PHP 3)
837
838         * xmlrpcs.inc: compatibility fixes for PHP 4.0.x versions
839
840         * testsuite.php: better support for running with php versions 4.0.x;
841         do not generate runtime errors but finish tests anyway if some calls to
842         localhost fail;
843         correctly detect a localhost port different from 80 for running tests against
844
845 2005-07-11  Gaetano Giunta <giunta.gaetano@gmail.com>
846
847         * xmlrpc.inc: preliminary building of method signature and docs in
848         wrap_php_function;
849         fix a bug in extracting function description from javadoc block in
850         wrap_php_function;
851         small fix for better compatibility with php < 4.2.0
852
853         * added compat subdir with extra code, taken form PEAR package Compat, to let
854         the lib run fine with php 4 versions < 4.1
855
856 2005-07-10  Gaetano Giunta <giunta.gaetano@gmail.com>
857
858         * xmlrpc.inc: some nazi whitespace corrections;
859         declared global $xmlrpcBoolean too (was the only one missing);
860         used @eval inside getval() to have less path disclosure security reports filed
861         in the future;
862         added new global var: $xmlrpcValue, to be used in server dispatch maps as
863         placeholder for a param which can be of any kind;
864         big chunks (but still incomplete) of javadoc parsing in wrap_php_function
865         + changed type of return val - now it is the complete array to be put in the
866         dispatch map
867
868         * xmlrpcs.inc: let previous error handler be called by server to handle errors
869         even if in debug level 3;
870         default to compress responses if zlib installed;
871         added a new val useful for only checking number (not type) of params in method
872         calls;
873         let user use object methods in dispatch map using the
874         array($obj, 'fmethodname') format
875
876         * server.php: Added code called by testsuite.php to exercise registration of
877         object methods as xmlrpc methods and auto-registration of php functions as xmlrpc
878         methods
879
880         * testsuite.php: added tests to exercice server registering object methods as
881         xmlrpc methods and automatic registration of php functions as server methods;
882         added a hint to enable debug if some test goes wrong;
883         renamed https test for better clarity
884
885 2005-07-07  Gaetano Giunta <giunta.gaetano@gmail.com>
886
887         * xmlrpc.inc: added function to be used for 'guestimating' charset encoding of
888         received xml (not activated yet)
889
890         * server.php: Let server compress content by default if user asks so: it allows
891         testsuite to check for compressed responses
892
893         * testsuite.php: added suite of tests for compressed responses; test CURL
894         (http1.1) with all possible compression combinations too
895
896 2005-07-06  Gaetano Giunta <giunta.gaetano@gmail.com>
897
898         * xmlrpc.inc: Enable setting usage of keepalives on/off (for CURL cases);
899         implement compression of xmlrpc requests; enable new syntax of xmlrpclient
900         constructor: 1 - allow preferred http method to be set at creation time,
901         2 - allow user to insert a single complete URL as only parameter and parse it;
902         try to detect if curl is present whether it has been compiled w. zlib to enable
903         automatically the reception of compressed responses
904
905         * xmlrpcs.inc: do not add into logs the content of the request, if it was
906         received gzipped/deflated, to avoid breaking the xml sent back as response
907         (NB: might be investigated further: is the problem caused by windows chars in
908         the range 128-160 ?)
909
910         * testsuite.php: run all localhost tests 2 more times, to stress request
911         compression;
912         run all localhost tests in a row using keepalives, to test keepalive
913         functionality
914
915 2005-07-05  Gaetano Giunta <giunta.gaetano@gmail.com>
916
917         * xmlrpc.inc: let CURL pass back to caller function the complete PHP headers
918         as it did before: it enables better logging / debugging of communication;
919         small change to the way CURL declares its ability to receive compressed
920         messages (fix for the case where zlib is compiled in PHP but not in curl);
921         added Keep-alive (ON BY DEFAULT) for http 1.1 and https messages (had to modify
922         a lot of functions for that);
923         always make sure a 'Connection: close' header is sent with curl connections if
924         keep-alive is not wanted
925
926         * phpunit.php: switched to PEAR PHPUnit (rel 1.2.3), since it is maintained a
927         lot more than the old version we were using
928
929         * added new folder with code of phpunit classes
930
931         * testsuite.php: added a new run of tests to check for compliance of client
932         when using http 1.1;
933         switched to PEAR PHPUnit classes;
934         divided test for client ability to do multicall() into 2 separate tests
935
936 2005-06-30  Gaetano Giunta <giunta.gaetano@gmail.com>
937
938         tagged and released version 1.1.1, backporting security fixes from HEAD
939
940 2005-06-28  Gaetano Giunta <giunta.gaetano@gmail.com>
941
942         * xmlrpcs.inc: fix changes introuced yesterday in a rush;
943         do not list system.* methods for a server that has them explicitly disabled
944
945         * bug_inject.xml: new test case used to check for code injection vulnerability
946
947         * testsuite.php: added a test case for zero parameters method calls;
948         added two test cases for recently found code injection vulnerabilities
949
950 2005-06-27  Gaetano Giunta <giunta.gaetano@gmail.com>
951
952         * xmlrpc.inc: (tentative) fix for security problem reported by
953         security@gulftech.org: we were not properly php-escaping xml received for
954         BASE64 and NAME tags;
955         some more patching related to junk received in xml messages/responses: if the
956         PHP code built from the parsed xml is broken, catch any generated errors
957         without echoing it to screen but take note of the error and propagate to user
958         code
959
960         * xmlrpcs.inc: some more patching related to junk received in xml messages/
961         responses: if the PHP code built from the parsed xml is broken, catch any
962         generated errors without echoing it to screen but take note of the error and
963         propagate to user code
964
965 2005-06-24  Gaetano Giunta <giunta.gaetano@gmail.com>
966
967         * xmlrpc.inc: fixed php_xmlrpc_encode detection of php arrays (again!);
968         removed from wrap_php_function the part about setting a custom error handler
969         (it can be activated using the more general $server->setdebug(3) anyway)
970
971         * xmlrpcs.inc: added to server the capability to trap all processing errors
972         during execution of user functions and add them to debug info inside responses;
973         return a (new) xmlrpcerr response instead of raising some obscure php execution
974         error if there is an undefined function in the dispatch map
975
976         * testsuite.php: Added new testcases for recently implemented stuff
977
978 2005-06-23  Gaetano Giunta <giunta.gaetano@gmail.com>
979
980         * xmlrpc.inc: added new method: xmlrpcval->structmemexists, to check for
981         presence of a wanted struct member without having to loop through all members;
982         fix wrap_php_functions: correctly return false for php internal functions,
983         whose param list is unknown;
984         let addscalar fail as it should if called on struct vals;
985         fix addstruct: do not fail when called for adding stuff to initialized structs;
986         removed a warning generated when calling addscalar with inexistent type;
987         massive code review for speed: replaced each() loops with foreach(), removed
988         lots of useless assignments and duplications of data;
989         added 'http11' as valid method param for xmlrpclient->send: makes use of curl
990         for sending http 1.1 requests;
991         changed a couple '=' into '=&' where objects are returned;
992         fixed wrap_php_function() to better detect php errors while processing wrapped
993         function
994
995         * xmlrpcs.inc: Fix php warnings generated when clients requested method
996         signature / description for a method that had none in its dispatch map;
997         turned server->debug into an integer value that will change the amount of
998         logging going as comments into xmlrpc responses
999
1000         * server.php: set default server debug level to 2
1001
1002         * testsuite.php: removed calls to deleted functions (xmlrpc_encode,
1003         xmlrpc_decode);
1004         added html page title describing target servers used for tests;
1005         added an assign-by-ref
1006
1007         * phpunit.php: Do not consider as failures PHP 5 E_STRICT errors (arbitrary
1008         choice, but lib is targeted at PHP 4)
1009
1010 2005-06-22  Gaetano Giunta <giunta.gaetano@gmail.com>
1011
1012         * xmlrpc.inc: removed lottsa old code that had been left in commented
1013
1014         * xmlrpc.inc: fixed setting of proxy port
1015
1016         * xmlrpc.inc: removed one warning when trying to decompress junk sent as
1017         deflated response
1018
1019         * xmlrpc.inc: changed the error messages (but not the code) that will be found
1020         in xmlrpcresponses when there are socket errors, to differentiate from HTTP
1021         errors
1022
1023         * xmlrpc.inc: refactored xmlrpcclient->sendpayloadHTTPS: now it calls a new
1024         method (sendpayloadCURL) that could be used also for generating HTTP 1.1
1025         requests
1026
1027         * xmlrpc.inc: added two new methods: wrap_php_function and wrap_xmlrpc_method:
1028         designed to let the lazy programmer automagically convert php functions to
1029         xmlrpc methods and vice versa. Details are in the code
1030
1031         * debugger/*: added initial revision of a 'universal xmlrpc debugger'
1032
1033 2005-06-20  Gaetano Giunta <giunta.gaetano@gmail.com>
1034
1035         * xmlrpc.inc: replace usage of 'echo' with error_log when errors arise
1036         in manipulation of xmlrpcval objects
1037
1038         * xmlrpc.inc: replaced <br> with <br /> in dump function
1039
1040         * xmlrpc.inc: added method structsize to xmlrpcval class (alias for arraysize)
1041
1042         * xmlrpc.inc: addarray() now will add extra members to an xmlrpcval object
1043         of array type; addstruct() can be used to add members to an xmlrpcval object
1044         of struct type
1045
1046         * xmlrpcs.inc: Added member allow_system_funcs to server: controls whether the
1047         server accepts or not calls to system.* functions
1048
1049 2005-05-10  Gaetano Giunta <giunta.gaetano@gmail.com>
1050
1051         * xmlrpc.inc: fix regression in php_xmlrpc_encode when encoding php hashes;
1052         fix decompression of gzip/deflated xmlrpc responses;
1053         set user agent string correctly in SSL mode (was forgetting lib name);
1054         add allowed encoding http headers in requests;
1055         do not pass http headers back from curl to parseresponse, to avoid re-decoding
1056         compressed xml or http 100 headers
1057
1058         * xmlrpcs.inc: added method setDebug;
1059         renamed compress_output to compress_response;
1060         do not try to set http headers if they have already been sent, because trying
1061         to do so will raise a PHP error, and if headers have been sent something has
1062         gone wrong already (shall we send a meaningful error response instead?)
1063
1064 2005-05-08  Gaetano Giunta <giunta.gaetano@gmail.com>
1065
1066         * xmlrpcs.inc, xmlrpcs.inc: reverted to usage of '=& new' for better
1067         performance on (some) php4 installs.
1068         NB: PHP 3 compatibility is deprecated from now on!
1069
1070         * xmlrpc.inc: decode xmlrpc boolean type to native php boolean
1071
1072         * xmlrpcs.inc, xmlrpcs.inc: switched $_xh[$parser] to $_xh, since indexing
1073         an array by object will give a warning in php 5 (and we were resetting the
1074         array of _xh elements on every call anyway)
1075
1076         * xmlrpc.inc: commented unused code used originally for escaping content
1077
1078         * xmlrpc.inc: commented deprecated methods xmlrpc_encode and xmlrpc_decode
1079
1080         * xmlrpc.inc: php_xmlrpc_encode: encode integer-indexed php arrays as xmlrpc
1081         arrays instead of structs; if object given to encode is an xmlrpcval return it
1082         instead of reencoding (makes easier calling encode on an array of xmlrpcvals)
1083
1084         * xmlrpcs.inc: added $debug field to server class; if false will prevent
1085         the server from echoing debug info back to the client as xml comment
1086
1087         * xmlrpcs.inc: let the server add to the debug messages the complete request
1088         payload received and (if php installed as apache module) http headers, so that
1089         the client in debug mode can echo a complete fingerprint of the communication
1090
1091         * xmlrpcs.inc: changed API of ParseRequest method: now it cannot be called
1092         without a 'data' parameter; added 2nd parameter (http encoding); changed the
1093         call to this method from inside service() method
1094
1095         * xmlrpc.inc, xmlrpcs.inc: enable both server and client to parse compressed xml
1096         (if php is compiled with zlib); client should also be able to decode chunked
1097         http encoding
1098
1099         * xmlrpc.inc: add support for proxies (only basic auth supported); default port
1100         is 8080 (if left unspecified)
1101
1102         * xmlrpc.inc: use lowercase for names of http headers received (makes using
1103         them much simpler, since servers can use any upper/lowercase combination)
1104
1105         * xmlrpc.inc: bumped version number to '2.0 beta'
1106
1107 2005-05-08  Gaetano Giunta <giunta.gaetano@gmail.com>
1108
1109         * release of version 1.1
1110
1111 2005-04-24  Gaetano Giunta <giunta.gaetano@gmail.com>
1112
1113         * xmlrpcs.inc: removed charset declaration from xml prologue of responses,
1114         since we are now escaping all non-ascii chars in an encoding-independent way
1115
1116         * bug_http.xml: modified to exercise some extra functonality of the lib
1117         (it should now be failed by the current PEAR implementation of the lib)
1118
1119         * xmlrpc.inc: bumped up rev. number to 1.1
1120
1121         * doc/xmlrpc_php.xml, doc/announce1_1.txt: documentation updates
1122
1123         * Makefile: updated to reflect new xml doc source, modified filelist
1124
1125 2005-04-17  Gaetano Giunta <giunta.gaetano@gmail.com>
1126
1127         * client.php, agesort.php, introspect.php, introspect_demo.php,
1128         which.php, test.pl, test.py: use as default target the server.php page hosted
1129         on phpxmlrpc.sf.net
1130
1131         * server.php: fix for register_globals off; refer to docs on phpxmlrpc.sf.net
1132
1133 2005-04-15 Miles Lott <milos@groupwhere.org>
1134
1135         code formatting and comments
1136
1137 2005-04-03  Gaetano Giunta <giunta.gaetano@gmail.com>
1138
1139         * xmlrpc.inc: make use of global var $xmlrpcName in building User_Agent HTTP
1140         header (in conjunction with $xmlrpcVersion)
1141
1142         * agesort.php, client.php, comment.php, dicuss.php, mail.php, server.php,
1143         which.php: various janitorial fixes
1144         + always html escape content received from xmlrpc server or from user input
1145         + make the scripts run fine with register_globals off an register_long_arrays off
1146         + always use the functions php_xmlrpc_en(de)code, even if the EPI extension
1147         is not installed
1148         + in mail.php, allow user to see script source even if support for .phps files
1149         is not configured in the local web server
1150
1151         * testsuite.php: better detection of local webserver hostname for running tests
1152         against (if the user did not supply a webserver name)
1153
1154 2005-03-21  Gaetano Giunta <giunta.gaetano@gmail.com>
1155
1156         * xmlrpcs.inc: revert to a PHP3 compatible script (change '=& new' to '= new')
1157
1158         * xmlrpc.inc: revert to a PHP3 compatible script (lottsa fixes)
1159
1160         * testsuite.php: default to using local server as test target if no user
1161         provided values are available instead of heddley.com server
1162
1163         * testsuite.php: play nice to PHP3 in retrieving user-passed values
1164
1165         * testsuite.php: fix constructor method name for a type of tests
1166
1167         * phpunit.php: fix all cases of call-time-pass-by-ref
1168
1169         * phpunit.php: rename Exception class to _Exception if the script is run with
1170         PHP 5 (exception is a reserverd word)
1171
1172 2005-03-19  Gaetano Giunta <giunta.gaetano@gmail.com>
1173
1174         * xmlrpc.inc: fixed bug in new http header parsing code in case there is
1175         no correct separator between response headers and body
1176
1177         * xmlrpc.inc: added recognizing and stripping of HTTP/1.1 100 response headers
1178
1179         * xmlrpc.inc: strip extra whitespace from response body, as well as any junk
1180         that comes after the last </MethodResponse> tag. It allows the server code to
1181         be put on public providers that add e.g. javascript advertising to served pages
1182
1183         * xmlrpc.inc: removed unused parts of code, trailing whitespace
1184
1185         * xmlrpc.inc: fix possible bug (?) in xmlrpc_ee for BOOLEAN values: true was
1186         being handled differently than false
1187
1188         * testsuite.php: added a new file-based test to stress the response parsing
1189         modifications recently introduced; enabled debugging for file based tests
1190
1191 2005-03-15  Gaetano Giunta <giunta.gaetano@gmail.com>
1192
1193         * xmlrpc.inc: fixed missing declaration of global vars in xmlrpc_dh,
1194         sendpayloadhttps and sendpayloadhttp10
1195
1196         * xmlrpc.inc: changed error message for invalid responses: 'enable debugging'
1197         is more clear that 'enabling debugging' (the user is being encouraged to do it)
1198
1199         * xmlrpc.inc: rewrote HTTP response header parsing. It should be more tolerant
1200         of invalid headers, give more accurate error messages and be marginally faster,
1201         too.
1202
1203         * xmlrpc.inc: cosmetic whitespace fixes and remove useless one-liners
1204
1205         * xmlrpc.inc: build a shorter PHP command line to be evaluated for rebuilding
1206         values from parsed xml: use '$val =& nex xmlrpcval("value")' for string values
1207         instead of '$val =& nex xmlrpcval("value", $xmlrpcString)'
1208
1209         * xmlrpc.inc: fix change introduced 2005/01/30 moving call to curl_close()
1210         too early: it did not work on error situations
1211
1212         * testsuite.php: fix name of testAddingTest method, renamed testErrosString
1213         into testErrorString and removed useless warning for register_globals=off case
1214
1215 2005-02-27  Gaetano Giunta <giunta.gaetano@gmail.com>
1216
1217         * xmlrpc.inc: do not echo XML parsing error to screen (it is already dumped
1218         into error log)
1219
1220         * xmlrpc.inc: set hdrs field into response object in case of XML parsing error
1221         (uniform behaviour with other responses)
1222
1223 2005-02-26  Gaetano Giunta <giunta.gaetano@gmail.com>
1224
1225         * xmlrpc.inc: use global var $xmlrpcVersion as number for user agent string
1226
1227         * xmlrpcs.inc: eliminate server side PHP warning and give back to caller
1228         a better error msg in case the called method exists but no signature matches
1229         the number of parameters
1230
1231 2005-02-20  Gaetano Giunta <giunta.gaetano@gmail.com>
1232
1233         * xmlrpc.inc: accept a + sign in front of floats / integers, since the spec
1234         clearly mentions it
1235
1236         * xmlrpc.inc, xmlrpcs.inc: renamed function XmlEntities to xmlrpc_encode_entitites,
1237         to avoid using the same name as an array already defined
1238
1239         * xmlrpc.inc: fix bug introduced with escaping of UTF8 chars in xmlrpc error
1240         responses: correct behaviour is to escape chars inside serialize(), not when
1241         calling the xmlrpcresp creator
1242
1243         * testsuite.php: made test suite more friendly to modern PHP configs, allowing
1244         register_globals to be off and to set in the URL all testing parameters;
1245         added tests for newly introduced fixes; renamed existing tests acording to the
1246         docs inside phpunit.php (e.g. no subclass of TestCase should have a name
1247         starting with test...)
1248
1249 2005-02-19  Gaetano Giunta <giunta.gaetano@gmail.com>
1250
1251         * xmlrpc.inc: accept patch 683153 by mah0: if timeout is set, allow all socket
1252         operations to timeout at the given time, not only the socket connection
1253
1254 2005-02-13  Gaetano Giunta <giunta.gaetano@gmail.com>
1255
1256         * xmlrpc.inc: be tolerant to double values received in exponential notation:
1257         even though the spec forbids their usage PHP is fine with them
1258
1259         * xmlrpc.inc: fix bug: new xmlrpcval('-1') was creating an empty value instead
1260         of a string value!
1261
1262         * xmlrpc.inc, xmlrpcs.inc: fix the payload encoding changes introduced by
1263         Andres Salomon on 2004-03-17: sending named html entities inside an xml chunk
1264         makes it invalid, and thus renders the lib absolutely non-interoperable with
1265         any other xmlrpc implementation; moreover the current implementation only ever
1266         worked for non-ascii requests, while breaking client-parsing of responses
1267         containing non-ascii chars.
1268         The principle of using entities is preserved though, because it allows the
1269         client to send correct xml regardless of php internal charset encoding vs.
1270         xml request charset encoding, but using 'character references' instead.
1271
1272         * xmlrpc.inc: encode (non-ascii) chars into charset entities also for error
1273         strings
1274
1275         * xmlrpcs.inc: encode (non-ascii) chars into charset entities also for debug
1276         messages
1277
1278         * xmlrpcs.inc: added 'Accept-Charset' header in http request to let the server
1279         know what kind of charset encoding we do expect to be used for responses
1280
1281         * xmlrpc.inc, xmlrpcs.inc: explicitly tell the xml parser what charset the
1282         application expects to receive content in (notably strings). A new variable,
1283         $xmlrpc_internalencoding, (defaulting to ISO-8859-1) defines what charset the
1284         parser will use for passing back string xmlrpcvals to the PHP application
1285         (both server-side and client-side).
1286         This allows transparent usage of e.g. UTF-8 for encoding xml messages between
1287         server and client and ISO-8859-1 for internal string handling.
1288         ISO-8859-1 is, AFAIK, PHP internal encoding for all installs except
1289         mbstring-enabled ones.
1290
1291 2005-02-12  Gaetano Giunta <giunta.gaetano@gmail.com>
1292
1293         * xmlrpcs.inc: use '$var =& new(' construct to assign objects: on older versions
1294         of PHP objects are first built then copied over if the ampersand is omitted.
1295         Using it should make the code a little bit faster...
1296
1297         * doc/xmlrpc.php: update lib version number, release date in preparation for
1298         next release
1299
1300         * makefile: update lib version number in preparation for next release
1301
1302         * xmlrpc.inc: split up parsing of xmlrpc INT and DOUBLE values. This allows
1303         finer-grained control over valid values: now the '.' char is not allowed
1304         any more inside int values.
1305
1306         * xmlrpc.inc: fix for bug #560303: ints and doubles starting with '0' chars are
1307         no more parsed as octal values
1308
1309 2005-01-30  Gaetano Giunta <giunta.gaetano@gmail.com>
1310
1311         * xmlrpc.inc: Modifed last change by Miles: the functions php_xmlrpc_encode
1312         and php_xmlrpc_decode are now always defined, regardless of the existence of
1313         XMLRPC-EPI.  This allows users to start using these functions as the 'default'
1314         functions, and pave the way for future deprecation of xmlrpc_encode/encode
1315         while maintaining a stable API.
1316
1317         * xmlrpc.inc: use '$var =& new(' construct to assign objects: on older versions
1318         of PHP objects are first built then copied over if the ampersand is omitted.
1319         Using it should make the code a little bit faster...
1320
1321         * xmlrpc.inc: close curl connection as soon as possible for https requests:
1322         it could save some memory / resources.
1323
1324         * xmlrpc.inc: added some extra info in the PHP error log message generated
1325         when an invalid xmlrpc integer/float value is encountered and we try to
1326         deserialize it.
1327
1328         * xmlrpc.inc: added @ char before fsockopen to avoid echoing useless warnings
1329         when connection to server fails; added the same to avoid echoing warnings when
1330         deserializing data of an unknown type
1331
1332         * xmlrpc.inc: reset the _xh array on each xmlrpc call: otherwise a new array
1333         member is created for each consecutive call and never destroyed, thus making it
1334         impossible to build an xmlrpc-client daemon beacuse of memory leaking.
1335
1336         * xmlrpc.inc: declare global the variables that are used as 'constants',
1337         so that xmlrpc.inc will work even if it is included from within a function
1338
1339 2004-12-27  Miles Lott <milos@groupwhere.org>
1340         * xmlrpc.inc: A new constant, XMLRPC_EPI_ENABLED, is defined depending on
1341         the existence of the function, xmlrpc_decode.  This function will exist in
1342         PHP if the extension, XMLRPC-EPI (http://xmlrpc-epi.sourceforge.net), is
1343         loaded.  It defines the functions xmlrpc_encode and xmlrpc_decode, which
1344         will conflict with functions of the same name in xmlrpc.inc.  If this
1345         extension is loaded, we instead use the names php_xmlrpc_encode and
1346         php_xmlrpc_decode.  Please look at server.php, testsuite.php, etc., for
1347         how this should be handled if using these functions.
1348
1349 2003-04-17  Andres Salomon  <dilinger@voxel.net>
1350         * xmlrpc.inc: encode strings using htmlentities() instead of
1351         htmlspecialchars(), and add xmlrpc_html_entity_xlate().  This
1352         should fix longstanding issues with sending weird chars (from
1353         non-USASCII codesets like UTF-8, ISO-8859-1, etc) that caused
1354         the xml parser to choke.  Multi-byte chars are now changed to
1355         entities before sending, so that the xmlrpc server doesn't need
1356         to know the encoding type of the POST data.
1357         * xmlrpcs.inc: call xmlrpc_html_entity_xlate before parsing
1358         request packet.  The parser chokes on unknown entities (the
1359         entities created by htmlentities() are exactly that; html
1360         entities, not xml entities), so they must be converted from
1361         name form (&eacute;) to numerical form (&#233;).
1362
1363 2003-01-12  Andres Salomon  <dilinger@voxel.net>
1364
1365         * released 1.0.99.2.
1366         * Makefile: separate doc/Makefile a bit more from Makefile,
1367         and add clean rules.
1368
1369 2003-01-10  Andres Salomon  <dilinger@voxel.net>
1370
1371         * xmlrpc.inc: xmlrpcresp and parseResponse cleanups; variable
1372         name renames ('xv' to 'val', for example), type checking, and
1373         stricter default values.
1374         * xmlrpc.inc: fix xmlrpcresp's faultcode; return -1 for FAULT
1375         responses from the server whose faultcodes don't reflect any
1376         errors.
1377
1378 2003-01-08  Andres Salomon  <dilinger@voxel.net>
1379
1380         * xmlrpc.inc: rename $_xh[$parser]['ha'] to
1381         $_xh[$parser]['headers'].
1382         * xmlrpc.inc: fix bugs related to $_xh[$parser]['headers];
1383         some places treated this as an array, others as a scalar.
1384         Treat unconditionally as an array.  Also wrap header debugging
1385         output in PRE tags.
1386
1387 2002-12-17  Andres Salomon  <dilinger@voxel.net>
1388
1389         * released 1.0.99.
1390         * Makefile: changed the tarball format/dist rule to a more
1391         conventional form, as well as normal release updates.
1392         * xmlrpc.inc: added setSSLVerifyPeer and setSSLVerifyHost; as
1393         of curl 7.10, various certificate checks are done (by default).
1394         The default for CURLOPT_SSL_VERIFYHOST is to ensure the common
1395         name on the cert matches the provided hostname. This breaks a
1396         lot of stuff, so allow users to override it.
1397         * doc/xmlrpc_php.sgml: updated documentation accordingly.
1398
1399 2002-09-06  Geoffrey T. Dairiki  <dairiki@dairiki.org>
1400
1401         Add support for system.multicall() to both the client
1402         and the server.
1403
1404         * testsuite.php: Add new tests 'testServerMulticall',
1405         and 'testClientMulticall'.
1406
1407         * xmlrpc.inc: Added new error messages for system.multicall().
1408         * xmlrpcs.inc: Added new procedure call system.multicall().
1409         See http://www.xmlrpc.com/discuss/msgReader$1208 for details.
1410
1411         * xmlrpc.inc: Added system.multicall functionality to
1412         xmlrpc_client.  xmlrpc_client::send can now take an array of
1413         xmlrpcmsg's as an argument.  In that case it will attempt
1414         to execute the whole array of procure calls in a single
1415         HTTP request using system.multicall().  (If that attempt fails,
1416         then the calls will be excuted one at a time.)  The return
1417         value will be an array of xmlrpcresp's (or 0 upon transport
1418         failure.)
1419
1420 2001-11-29  Edd Dumbill  <edd@usefulinc.com>
1421
1422         * xmlrpc.inc: fixed problem with processing HTTP headers that
1423         broke any payload with more than one consecutive newline in it.
1424         also initialise the 'ac' array member to empty string at start.
1425         * testsuite.php: added unit test to exercise above bug
1426         * xmlrpcs.inc: fixed uninitialized variable $plist
1427
1428 2001-09-25  Edd Dumbill  <edd@usefulinc.com>
1429
1430         * xmlrpc.inc: applied urgent security fixes as identified by Dan
1431         Libby
1432
1433 2001-08-27  Edd Dumbill  <edd@usefulinc.com>
1434
1435         * xmlrpc.inc: Merged in HTTPS support from Justin Miller, with a
1436         few additions for better traceability of failure conditions. Added
1437         small fix from Giancarlo Pinerolo. Bumped rev to 1.0. Changed
1438         license to BSD license.
1439
1440 2001-06-15  Edd Dumbill  <edd@usefulinc.com>
1441
1442         * xmlrpcs.inc: Added \r into return MIME headers for server class
1443
1444 2001-04-25  Edd Dumbill  <edd@usefulinc.com>
1445
1446         * server.php: Added interop suite of methods.
1447
1448 2001-04-24  Edd Dumbill  <edd@usefulinc.com>
1449
1450         * testsuite.php: added in test case for string handling bug.
1451
1452         * xmlrpc.inc: merged in minor fixes from G Giunta to fix
1453         noninitialization. Created new method, getval(), which includes
1454         experimental support for recreating nested arrays, from Giunta and
1455         Sofer. Fixed string handling bug where characters after </string>
1456         but before </value> weren't ignored. Added in support for native
1457         boolean type into xmlrpc_encode (Giunta).
1458
1459         * xmlrpcs.inc: updated copyright notice
1460
1461 2001-01-15  Edd Dumbill  <edd@usefulinc.com>
1462
1463         * xmlrpc.inc: fixed bug with creation of booleans. Put checks in
1464         to ensure that numbers were really numeric. Fixed bug with
1465         non-escaping of dollar signs in strings.
1466
1467         * testsuite.php: created test suite.
1468
1469 2000-08-26  Edd Dumbill  <edd@usefulinc.com>
1470
1471         * xmlrpcs.inc: added xmlrpc_debugmsg() function which outputs
1472         debug information in comments inside the return payload XML
1473
1474         * xmlrpc.inc: merged in some changes from Dan Libby which fix up
1475         whitespace handling.
1476
1477         * xmlrpcs.inc: added Content-length header on response (bug from
1478         Jan Varga <varga@utcru.sk>. This means you can no longer print
1479         during processing
1480
1481         * xmlrpc.inc: changed ereg_replace to str_replace in several
1482         places (thanks to Dan Libby <dan@libby.com> for this).
1483
1484         * xmlrpc.inc: added xmlrpc_encode() and xmlrpc_decode() from Dan
1485         Libby--these helper routines make it easier to work in native PHP
1486         data structures.
1487
1488 2000-07-21  Edd Dumbill  <edd@usefulinc.com>
1489
1490         * xmlrpc.inc: added xmlrpc_client::setCredentials method to pass
1491         in authorization information, and modified sendPayload* methods to
1492         send this OK. Thanks to Grant Rauscher for the impetus to do this.
1493         Also, made the client send empty <params></params> if there are no
1494         parameters set by the user.
1495
1496         * doc/xmlrpc_php.sgml: updated documentation to reflect recent
1497         changes
1498
1499
1500 2000-07-18  Edd Dumbill  <edd@usefulinc.com>
1501
1502         * server.php: added examples.invertBooleans method to server as a
1503         useful test method for boolean values.
1504
1505         * xmlrpc.inc: rearranged the way booleans are handled to fix
1506         outstanding problems. Fixed calling addScalar() on arrays so it
1507         works. Finally fixed backslashification issues to remove the
1508         problem will dollar signs disappearing.
1509
1510         * booltest.php: really fixed booleans this time.
1511
1512 2000-06-03  Edd Dumbill  <edd@usefulinc.com>
1513
1514         * xmlrpcs.inc: made signature verification more useful - now
1515         returns what it found was wrong
1516
1517         * xmlrpc.inc: fixed bug with decoding dateTimes. Also fixed a bug
1518         which meant a PHP syntax error happened when attempting to receive
1519         empty arrays or structs. Also fixed bug with booleans always being
1520         interpreted as 'true'.
1521
1522         * server.php: Added validator1 suite of tests to test against
1523         validator.xmlrpc.com
1524
1525
1526 2000-05-06  Edd Dumbill  <edd@usefulinc.com>
1527
1528         * released 1.0b6
1529
1530         * added test.pl and test.py, Perl and Python scripts that exercise
1531         server.php somewhat (but not a lot)
1532
1533         * added extra fault condition for a non 200 OK response from the
1534         remote server.
1535
1536         * added iso8601_encode() and iso8601_decode() to give some support
1537         for passing dates around. They translate to and from UNIX
1538         timestamps. Updated documentation accordingly.
1539
1540         * fixed string backslashification -- was previously a little
1541         overzealous! new behavior is '\' --> '\\' and '"' -->
1542         '\"'. Everything else gets left alone.
1543
1544 2000-04-12  Edd Dumbill  <edd@usefulinc.com>
1545
1546         * updated and bugfixed the documentation
1547
1548         * fixed base 64 encoding to only happen at serialize() time,
1549         rather than when a base64 value is created. This fixes the double
1550         encoding bug reported by Nicolay Mausz
1551         <castor@flying-dog.com>. The same approach ought to be taken with
1552         encoding XML entities in the data - this is a TODO.
1553
1554         * integrated further code from Peter Kocks: used his new code for
1555         send(), adding a second, optional, parameter which is a timeout
1556         parameter to fsockopen()
1557
1558 1999-10-11  Edd Dumbill  <edd@usefulinc.com>
1559
1560         * added bug fixes from Peter Kocks <peter.kocks@baygate.com>
1561
1562 1999-10-10  Edd Dumbill  <edd@usefulinc.com>
1563
1564         * updated the documentation
1565
1566 1999-10-08  Edd Dumbill  <edd@usefulinc.com>
1567
1568         * added system.* methods and dispatcher, plus documentation
1569
1570         * fixed bug which meant request::getNumParams was returning an
1571         incorrect value
1572
1573         * added signatures into the dispatch map. This BREAKS
1574         COMPATIBILITY with previous releases of this code
1575
1576 1999-08-18  Edd Dumbill  <edd@usefulinc.com>
1577
1578         * made entity encoding and decoding transparent now on string
1579         passing.
1580
1581         * de-globalised the globals in the parse routines, using an
1582         associative array to hold all parser state $_xh
1583
1584         * changed default input encoding to be UTF-8 to match expectation
1585
1586         * separated out parseResponse into parseResponse and
1587         parseResponseFile so that you can call parseResponse on a string
1588         if you have one handy
1589
1590 1999-07-20  Edd Dumbill  <edd@usefulinc.com>
1591
1592         * Moved documentation into Docbook format
1593
1594 1999-07-19  Edd Dumbill  <edd@usefulinc.com>
1595
1596         * Added an echo server into server.php and echotest.php, a client
1597         which will exercise the new echo routine.
1598
1599         * Added test for no valid value returned: in this case will now
1600         throw the error "invalid payload"
1601
1602         * Added serialize() method to xmlrpcresp to return a string with
1603         the response serialized as XML
1604
1605         * Added automatic encoding and decoding for base64 types
1606
1607         * Added setDebug() method to client to enable HTML output
1608         debugging in the client
1609
1610 1999-07-08  Edd Dumbill  <edd@usefulinc.com>
1611
1612         * Improved XML parse error reporting on the server side to send it
1613         back in a faultCode packet. expat errors now begin at 100
1614
1615 1999-07-07  Edd Dumbill  <edd@usefulinc.com>
1616
1617         * Changed the structmem and arraymem methods of xmlrpcval to always
1618         return xmlrpc vals whether they referred to scalars or complex
1619         types.
1620
1621         * Added the server class and demonstrations
1622
1623         * Fixed bugs in the XML parsing and reworked it