Provides emulation of the native XML-RPC extension for PHP
OTHER License
A pure-php reimplementation of the API exposed by the native XML-RPC extension.
Originally bundled as part of the phpxmlrpc/extras package.
Any PHP version from 5.4 to 8.3 is supported.
The phpxmlrpc/phpxmlrpc
library is used as the underlying XML-RPC engine. It will get automatically pulled in for you
when you install via Composer.
Installation: the recommended way to install this library is via usage of Composer. Just add
"phpxmlrpc/polyfill-xmlrpc": "^1.0.0"
to your Composer "require" section.
Usage: once your autoload configuration is set up properly (which is normally taken care for you by Composer), you can just use in your code all the functions described at https://www.php.net/manual/en/ref.xmlrpc.php
This library is not fully complete yet, but it should be good enough for most users.
The main features missing are:
$encoding
argument to xmlrpc_decode()
and xmlrpc_decode_request()
'encoding' => 'UTF-8'
and 'escaping' => 'markup'
in the $options
argument to xmlrpc_encode_request
xmlrpc_parse_method_descriptions
and xmlrpc_server_register_introspection_callback
functions exist but do nothingxmlrpc_encode_request
function has partial support for the $options
argumentFor a detailed list of all known differences compared to the behaviour of the PHP extension, see comments at the top of file XmlRpc.php.
We strive to reproduce the same behaviour as the XML-RPC extension to the best "reasonable" extent.
This means that the following are not goals of this package:
being able to produce the same xml streams as the native extension, where "same" means byte-by-byte identical. Eg. whitespace and element indentation in the produced xml strings do differ
reproducing behaviour of the native extension which is clearly buggy
Eg. the native extension will produce invalid xmlrpc requests when some specific values are passed to an
xmlrpc_encode_request
call
The recommended way to run the library test suite is via the provided Docker containers. A handy shell script is available that simplifies usage of Docker.
The full sequence of operations is:
./tests/ci/vm.sh build
./tests/ci/vm.sh start
./tests/ci/vm.sh runtests
./tests/ci/vm.sh stop
# and, once you have finished all testing related work:
./tests/ci/vm.sh cleanup
By default, tests are run using php 7.4 in a Container based on Ubuntu 20 Focal. You can change the version of PHP and Ubuntu in use by setting the environment variables PHP_VERSION and UBUNTU_VERSION before building the Container.
To generate the code-coverage report, run ./tests/ci/vm.sh runcoverage
Q: is it possible to specify the precision used to serialize Double values?
A: yes, by setting a positive integer value to \PhpXmlRpc\Polyfill\XmlRpc\XmlRpc::$xmlpc_double_precision
Use of this software is subject to the terms in the license.txt file