1 XML-RPC for PHP version 2.2.1 - 2008/03/06
\r
3 This release corrects all bugs that have been reported and sucesfully reproduced.
\r
4 It is the last release of the library that will support PHP 4.
\r
6 * fixed: work aroung bug in php 5.2.2 which broke support of HTTP_RAW_POST_DATA
\r
7 * fixed: is_dir parameter of setCaCertificate() method is reversed
\r
8 * fixed: a php warning in xmlrpc_client creator method
\r
9 * fixed: parsing of '1e+1' as valid float
\r
10 * fixed: allow errorlevel 3 to work when prev. error handler was a static method
\r
11 * fixed: usage of client::setcookie() for multiple cookies in non-ssl mode
\r
12 * improved: support for CP1252 charset is not part or the library but almost possible
\r
13 * improved: more info when curl is enabled and debug mode is on
\r
16 XML-RPC for PHP version 2.2 - 2007/02/25
\r
18 This release corrects a couple of bugs and adds a few minor features.
\r
20 * fixed: debugger errors on php installs with magic_quotes_gpc on
\r
21 * fixed: support for https connections via proxy
\r
22 * fixed: wrap_xmlrpc_method() generated code failed to properly encode php objects
\r
23 * improved: slightly faster encoding of data which is internally UTF-8
\r
24 * improved: debugger always generates a 'null' id for jsonrpc if user omits it
\r
25 * new: debugger can take advantage of a graphical value builder
\r
26 (it has to be downloaded separately, as part of jsxmlrpc package)
\r
27 * new: support for the <NIL/> xmlrpc extension
\r
28 * new: server support for the system.getCapabilities xmlrpc extension
\r
29 * new: wrap_xmlrpc_method() accepts two new options: debug and return_on_fault
\r
32 XML-RPC for PHP version 2.1 - 2006/08/28
\r
34 This release corrects quite a few bugs and adds some interesting new features.
\r
35 There is a minor security enhancement and overall speedup too.
\r
37 It has been tested with PHP 4.0.5 up to 4.4.4 and 5.1.5.
\r
38 Please note that 404pl1 is NOT supported, and has not been since 2.0.
\r
40 *** PLASE READ CAREFULLY BELOW ***
\r
42 CHANGES THAT MIGHT AFFECT DEPLOYED APPLICATIONS:
\r
44 The wrap_php_function and wrap_xmlrpc_method functions have been moved out of
\r
45 the base library file xmlrpc.inc into a file of their own: xmlrpc_wrappers.inc.
\r
46 You will have to include() / require() it in your scripts if you have been using
\r
49 For increased security, the automatic rebuilding of php object instances out of
\r
50 received xmlrpc structs in wrap_xmlrpc_method() has been disabled (but it can be
\r
51 optionally reenabled).
\r
53 The constructor of xmlrpcval() values has seen major changes, and it will not
\r
54 throw a php warning anymore when invoked using an unknown xmlrpc type: the
\r
55 error will only be written to php error log. Also new xmlrpcval('true', 'boolean')
\r
56 is not supported anymore.
\r
60 The new function php_xmlrpc_decode_xml() will take the xml representation of
\r
61 either an xmlrpc request, response or single value and return the corresponding
\r
62 php-xmlrpc object instance.
\r
64 Both wrap_php_function() and wrap_xmlrpc_method() functions accept many more
\r
65 options to fine tune their behaviour, including one to return the php code to
\r
66 be saved and later used as standalone php script.
\r
68 A new function wrap_xmlrpc_server() has been added, to wrap all (or some) of the
\r
69 methods exposed by a remote xmlrpc server into a php class.
\r
71 Lib internals have been modified to provide better support for grafting extra
\r
72 functionality on top of it. Stay tuned for future releases of the EXTRAS package.
\r
74 Last but not least a new file has been added: verify_compat.php, to help users
\r
75 diagnose the level of compliance of the current php install with the library.
\r
77 CHANGELOG IN DETAIL:
\r
79 * fixed bug 1311927: client not playing nice with some proxy/firewall on ports != 80
\r
80 * fixed bug 1334340: all ereg_ functions have been replaced with corresponding preg_
\r
81 * fixed bug: wrong handling of 'deflate' http encoding, both server and client side
\r
82 * fixed bug: sending compressed responses when php output compression is enabled was not working
\r
83 * fixed bug: addarray() and addstruct() where not returning 1 when adding data to already initialized values
\r
84 * fixed bug: non-ascii chars used in struct element names where not being encoded correctly
\r
85 * restored compatibility with php 4.0.5 (for those poor souls still stuck on it)
\r
86 * server->service() now returns either the payload or xmlrpcresp instance
\r
87 * server->add_to_map() now accepts methods with no param definitions
\r
88 * added new function: php_xmlrpc_decode_xml()
\r
89 * added new function: wrap_xmlrpc_server()
\r
90 * major improvements and security enhancements to wrap_php_function() and wrap_xmlrpc_method()
\r
91 * documentation for single parameters of exposed methods can be added to the dispatch map
\r
92 (and turned into html docs in conjunction with a future release of the extras package)
\r
93 * full response payload is saved into xmlrpcresp object for further debugging
\r
94 * stricter parsing of incmoing xmlrpc messages: two more invalid cases are now detected
\r
95 (double data element inside array and struct/array after scalar inside value element)
\r
96 * debugger can now generate code that wraps a remote method into php function (works for jsonrpc, too)
\r
97 * debugger has better support for being activated via a single GET call (for integration into other tools?)
\r
98 * more logging of errors in a lot of situations
\r
99 * javadoc documentation of lib files almost complete
\r
100 * the usual amount of new testcases in the testsuite
\r
101 * many performance tweaks and code cleanups
\r
102 * added foundation for emulating the API of the xmlrpc extension (extras package needed)
\r
105 XML-RPC for PHP version 2.0 - 2006/04/24
\r
107 I'm pleased to announce XML-RPC for PHP version 2.0, final.
\r
109 With respect to the last release candidate, this release corrects a few small
\r
110 bugs and adds a couple of new features: more authentication options (digest and
\r
111 ntlm for servers, ntlm for proxies, and some https custom certificates stuff);
\r
112 all the examples have been reviewed and some demo files added,
\r
113 including a ready-made xmlrpc proxy (useful e.g. for ajax calls, when the xmlrpc
\r
114 client is a browser); the server logs more warning messages for incorrect situations;
\r
115 both client and server are more tolerant of commonly-found mistakes.
\r
116 The debugger has been upgraded to reflect the new client capabilities.
\r
120 * fixed bug: method xmlrpcval::structmemexists($value) would not work
\r
121 * fixed bug: wrap_xmlrpc_method would fail if invoked with a client object that
\r
122 has return_type=phpvals
\r
123 * fixed bug: in case of call to client::multicall without fallback and server error
\r
124 * fixed bug: recursive serialization of xmlrpcvals loosing specified UTF8 charset
\r
125 * fixed bug: serializing to ISO-8859-1 with php 5 would raise an error if non-ascii
\r
126 chars where found when decoding
\r
127 * new: client can use NTLM and Digest authentication methods for https and http 1.1
\r
128 connections; authentication to proxy can be set to NTLM, too
\r
129 * new: server tolerates user functions returning a single xmlrpcval object instead
\r
131 * new: server does more checks for presence and correct return type of user
\r
132 coded method handling functions, and logs inconsistencies to php error log
\r
133 * new: client method SetCaCertificate($cert, $is_dir) to validate server against
\r
134 * new: both server and client tolerate receiving 'true' and 'false' for bool values
\r
135 (which btw are not valid according to the xmlrpc spec)
\r
138 XML-RPC for PHP version 2.0RC3 - 2006/01/22
\r
140 This release corrects a few bugs and adds some interesting new features.
\r
141 It has been tested with PHP up to 4.4.2 and 5.1.2.
\r
143 * fixed bug: server not recognizing clients that declare support for http compression
\r
144 * fixed bug: serialization of new xmlrpcval (8, 'string') when internal encoding
\r
146 * fixed bug: serialization of new xmlrpcval ('hello', 'int') would produce
\r
148 * new: let the server accept 'class::method' syntax in the dispatch map
\r
149 * new: php_xmlrpc_decode() can decode xmlrpcmessage objects
\r
150 * new: both client and server can specify a charset to be used for serializing
\r
151 values instead of the default 'US-ASCII+xml-entities-for-other-characters'.
\r
152 Values allowed: ISO-8859-1 and UTF-8
\r
153 * new: the server object can register 'plain' php functions instead of functions
\r
154 that accept a single parameter of type xmlrpcmsg. Faster, uses less memory
\r
155 (but comes with minor drawbacks as well, read the manual for more details)
\r
156 * new: client::setDebug(2) can be used to have the request payload printed to
\r
157 screen before being sent
\r
158 * new: server::service($data) lets user parse data other than POST body, for
\r
159 easier testing / subclassing
\r
160 * changed: framework-generated debug messages are sent back by the server base64
\r
161 encoded, to avoid any charset/xml compatibility problem
\r
162 * other minor fixes
\r
164 The usual refactoring of a lot of (private) methods has taken place, with new
\r
165 parameters added to some functions.
\r
166 Javadoc documentation has been improved a lot.
\r
167 The HTML documentation has been shuffled around a bit, hoping to give it a more
\r
168 logical organization.
\r
170 The experimental support for the JSON protocol has been removed, and will be
\r
171 packaged as a separate download with some extra very interesting stuff (human
\r
172 readable auto-generated documentation, anyone?).
\r
175 XML-RPC for PHP version 2.0RC2 - 2005/11/22
\r
177 This release corrects a few bugs and adds basically one new method for better
\r
180 * fixed two bugs that prevented xmlrpc calls to take place over https
\r
181 * fixed two bugs that prevented proper recognition of xml character set
\r
182 when it was declared inside the xml prologue
\r
183 * added xmlrpc_client::setKey($key, $keypass) method, to allow using client
\r
184 side certificates for https connections
\r
185 * fixed bug that prevented proper serialization of string xmlrpcvals when
\r
186 $xmlrpc_internalencoding was set to UTF-8
\r
187 * fixed bug in xmlrpc_server::echoInput() (and marked method as deprecated)
\r
188 * correctly set cookies/http headers into xmlrpcresp objects even when the
\r
189 sned() method call fails for some reason
\r
190 * added a benchmark file in the testsuite directory
\r
192 A couple of (private/protected) methods have been refactored, as well as a
\r
193 couple of extra parameters added to some (private) functions - this has no
\r
194 impact on the public API and should be of interest primarily to people extending
\r
195 / subclassing the lib.
\r
197 There is also new, PARTIAL support for the JSON-RPC protocol, implemented in
\r
198 two files in the extras dir (more info about json-rpc at http://json-rpc.org)
\r
201 XML-RPC for PHP version 2.0RC1 - 2005/10/03
\r
203 I'm pleased to announce XML-RPC for PHP version 2.0, release candidate 1.
\r
205 This release introduces so many new features it is almost impossible to list them
\r
206 here, making the library finally on pair with, if not more advanced than, any other
\r
207 similar offer (e.g. the PEAR XMLRPC package or the Incutio IXR library).
\r
208 No, really, trust me.
\r
210 The minimum supported PHP version is now 4.2 - natively - or 4.0.4pl1 - by usage of
\r
211 a couple of compatibility classes (code taken from PEAR php_compat package).
\r
213 The placement of files and directories in the distribution has been deeply modified,
\r
214 in the hope of making it more clear, now that the file count has increased.
\r
215 I hope you find it easy.
\r
217 Support for "advanced" HTTP features such as cookies, proxies and keep-alives has
\r
218 been added at last.
\r
220 It is now much easier to convert between xmlrpcval objects and php values, and
\r
221 in fact php_xmlrpc_encode and php_xmlrpc_decode are now the recommended methods
\r
222 for all cases, except when encoding base64 data.
\r
224 Two new (experimental) functions have been added, allowing automagic conversion
\r
225 of a php function into an xmlrpc method to be exposed and vice-versa.
\r
227 PHP objects can be now automatically serialized as xmlrpc struct values and
\r
228 correctly deserialized on the other end of the transmission, provided that the
\r
229 same class definition is present on both sides and no object members are of
\r
232 A lot of the existing class methods have been overloaded with extra parameters
\r
233 or new functionality, and a few added ex-novo, making usage easier than ever.
\r
235 A complete debugger solution is included in the distribution. It needs a web server
\r
236 to run (a freely available version of the same debugger is accessible online, it
\r
237 can be found at http://phpxmlrpc.sourceforge.net).
\r
239 For a more detailed list of changes, please read carefully chapter 2 of the
\r
240 included documentation, or, even better, take a look at the source code, which
\r
241 is commented in javadoc style quite a bit.
\r
244 XML-RPC for PHP version 1.2 - 2005/08/14
\r
246 This removes all use of eval(), which is a potential security problem.
\r
247 All users are encouraged to upgrade as soon as possible.
\r
248 As of this release we are no longer php3-compatible.
\r
251 XML-RPC for PHP version 1.1.1 - 2005/06/30
\r
253 This is a security vulnerability fix release.
\r
254 All users are invited to upgrade as soon as possible.
\r
257 XML-RPC for PHP version 1.1 - 2005/05/03
\r
259 I'm pleased to announce XML-RPC for PHP version 1.1
\r
260 It's taken two years to get to the this point, but here we are, finally.
\r
262 This is a bugfix and maintenance release. No major new features have been added.
\r
263 All known bugs have been ironed out, unless fixing would have meant breaking
\r
265 The code has been tested with PHP 3, 4 and 5, even tough PHP 4 is the main
\r
266 development platform (and some warnings will be emitted when runnning PHP5).
\r
268 Notheworthy changes include:
\r
270 * do not clash any more with the EPI xmlrpc extension bundled with PHP 4 and 5
\r
271 * fixed the unicode/charset problems that have been plaguing the lib for years
\r
272 * proper parsing of int and float values prepended with zeroes or the '+' char
\r
273 * accept float values in exponential notation
\r
274 * configurable http user-agent string
\r
275 * use the same timeout on client socket reads as used for connecting
\r
276 * more explicative error messages in xmlrpcresponse in many cases
\r
277 * much more tolerant parsing of malformed http responses from xmlrpc servers
\r
278 * fixed memleak that prevented the client to be used in never-ending scripts
\r
279 * parse bigger xmlrpc messages without crashing (1MB in size or more)
\r
280 * be tolerant to xmlrpc responses generated on public servers that add
\r
281 javascript advertising at the end of hosted content
\r
282 * the lib generates quite a few less PHP warnings during standard operation
\r
284 This is the last release that will support PHP 3.
\r
285 The next release will include better support for PHP 5 and (possibly) a slew of
\r
288 The changelog is available at:
\r
289 http://cvs.sourceforge.net/viewcvs.py/phpxmlrpc/xmlrpc/ChangeLog?view=markup
\r
291 Please report bugs to the XML-RPC PHP mailing list or to the sourceforge project
\r
292 pages at http://sourceforge.net/projects/phpxmlrpc/
\r
git://git.onelab.eu / plcapi.git / blob