phpxmlrpc / polyfill-xmlrpc
A pure-php reimplementation of the API exposed by the native XML-RPC extension
Installs: 11 096
Dependents: 0
Suggesters: 0
Security: 0
Stars: 5
Watchers: 2
Forks: 3
Open Issues: 0
Requires
- php: ^5.3.0 || ^7.0 || ^8.0
- phpxmlrpc/phpxmlrpc: ^4.5.2
Requires (Dev)
- ext-curl: *
- phpunit/phpunit: ^5.0 || ^8.5.12
- phpunit/phpunit-selenium: *
- yoast/phpunit-polyfills: *
Suggests
- ext-iconv: Required when using anything other than utf-8 as target encoding for the decoded xml
- ext-xmlrpc: Recommended for running the test suite. We can not declare it in require-dev because it is missing in php 8
Provides
- ext-xmlrpc: *
This package is auto-updated.
Last update: 2023-03-20 11:07:52 UTC
README
A pure-php reimplementation of the API exposed by the native XML-RPC extension.
Originally bundled as part of the phpxmlrpc/extras package.
Known differences from the original extension
Work in Progress!
This library is not complete yet, and thus to be considered a Work in Progress.
Main features missing are:
- character set handling: at the moment only utf-8 and iso-8859-1 are supported; iso-8859-1 as default, and utf-8 via:
- using the
$encoding
argument toxmlrpc_decode()
andxmlrpc_decode_request()
- setting
'encoding' => 'UTF-8'
and'escaping' => 'markup'
in the$options
argument toxmlrpc_encode_request
- using the
- the
xmlrpc_parse_method_descriptions
andxmlrpc_server_register_introspection_callback
functions exist but do nothing - the
xmlrpc_encode_request
function has partial support for the$options
argument
For a detailed list of all known differences compared to the behaviour of the PHP extension, see comments at the top of file XmlRpc.php.
Compatibility goals
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 specific values are passed to an
xmlrpc_encode_request
call
Installation and usage
The recommended way to install this library is via usage of Composer.
Running tests
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
FAQ
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
License
Use of this software is subject to the terms in the license.txt file