eappointment/zmsclient

Use this library to fetch data from the eappointment API via HTTP.

2.27.04 2024-12-10 15:52 UTC

README

pipeline status coverage report

Use this library to fetch data from the eappointment API via HTTP.

For a detailed project description, see https://gitlab.com/eappointment/eappointment

Requirements

  • PHP 7.3+

Installation

Usually this module is required by other modules and does not need any special installation. Add the following lines to your composer.json:

composer require eappointment/zmsclient

Usage

$http = new \BO\Zmsclient\Http("https://eappointment.example.com/api/2");
$result = $http->readGetResult('/status/');
$entity = $result->getEntity();
var_dump($entity->version);

Configuration

Setting up default CURL-Options, use the following line:

\BO\Zmsclient\Psr7\Client::$curlopt = [
    CURLOPT_SSL_VERIFYPEER => false,
    CURLOPT_TIMEOUT => 3,
    //CURLOPT_VERBOSE => true,
];

Testing

If you want to run the test, docker-compose is required. Testing needs an HTTP server to answer the HTTP calls from this library.

Run the following command:

docker-compose up

The docker-compose starts the mockup server, waits 10 seconds and starts the unit tests. After the tests are finished, the mockup server is still running. If there are failures, you need to lookup possible HTTP calls. There is a port forwarding and you can see the calls under http://localhost:8082/