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