X-Git-Url: http://git.onelab.eu/?a=blobdiff_plain;f=php%2Fphpxmlrpc%2FREADME.md;h=64d829cefe6a21e587e7d65a73606a9af79e0425;hb=c379c0fff5edc592cc5d5d647c7fadb91317db87;hp=2b48d5e86dbc540c0268a4c743869fcf9124ef73;hpb=ae8b10f8363f7a1df02e77cbd820904c4ded10b8;p=plcapi.git diff --git a/php/phpxmlrpc/README.md b/php/phpxmlrpc/README.md index 2b48d5e..64d829c 100644 --- a/php/phpxmlrpc/README.md +++ b/php/phpxmlrpc/README.md @@ -11,13 +11,16 @@ Detailed installation instructions are in the [INSTALL.md](INSTALL.md) file, alo Documentation ------------- -*NB: the user manual has not been updated yet with all the changes made in version 4. Please consider it unreliable!* - -*You are encouraged to look instead the code examples found in the demo/ directory* +See the documentation page at [gggeek.github.io/phpxmlrpc](https://gggeek.github.io/phpxmlrpc) for a list of the +library main features and all project related information. The user manual can be found in the doc/manual directory, in Asciidoc format: [phpxmlrpc_manual.adoc](doc/manual/phpxmlrpc_manual.adoc) -Release tarballs also contain the HTML and PDF versions, as well as an automatically generated API documentation. +Older release tarballs also contain HTML and PDF versions of the manual, as well as an automatically generated API documentation. + +*NB: the user manual has not been updated yet with all the changes made in version 4. Please consider it unreliable!* + +*You are encouraged to look instead the code examples found in the demo/ directory* Upgrading --------- @@ -30,19 +33,36 @@ If you are upgrading from version 3 or earlier you have two options: In any case, read carefully the docs in [doc/api_changes_v4.md](doc/api_changes_v4.md) and report back any undocumented issue using GitHub. +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.2 in a Container based on Ubuntu 18 Bionic. +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` + License ------- Use of this software is subject to the terms in the [license.txt](license.txt) file -SSL-certificate ---------------- -The passphrase for the rsakey.pem certificate is 'test'. - [![License](https://poser.pugx.org/phpxmlrpc/phpxmlrpc/license)](https://packagist.org/packages/phpxmlrpc/phpxmlrpc) [![Latest Stable Version](https://poser.pugx.org/phpxmlrpc/phpxmlrpc/v/stable)](https://packagist.org/packages/phpxmlrpc/phpxmlrpc) [![Total Downloads](https://poser.pugx.org/phpxmlrpc/phpxmlrpc/downloads)](https://packagist.org/packages/phpxmlrpc/phpxmlrpc) -[![Build Status](https://travis-ci.org/gggeek/phpxmlrpc.svg?branch=php53)](https://travis-ci.org/gggeek/phpxmlrpc) -[![Test Coverage](https://codeclimate.com/github/gggeek/phpxmlrpc/badges/coverage.svg)](https://codeclimate.com/github/gggeek/phpxmlrpc) -[![Code Coverage](https://scrutinizer-ci.com/g/gggeek/phpxmlrpc/badges/coverage.png?b=php53)](https://scrutinizer-ci.com/g/gggeek/phpxmlrpc/?branch=php53) +[![Build Status](https://github.com/gggeek/phpxmlrpc/actions/workflows/ci.yml/badge.svg)](https://github.com/gggeek/phpxmlrpc/actions/workflows/ci.yml) +[![Code Coverage](https://scrutinizer-ci.com/g/gggeek/phpxmlrpc/badges/coverage.png)](https://scrutinizer-ci.com/g/gggeek/phpxmlrpc)