README

Abandoned Package -- Migrate Now!

As of September 10, 2023, this package is no longer being maintained.

Please update to the new version at https://github.com/TextControl/textcontrol-reportingcloud.

⚠️ Be sure to review the CHANGELOG.md of the new package.

ReportingCloud PHP SDK

This is the official PHP SDK for the ReportingCloud Web API. It is authored and supported by Text Control GmbH.

Learn more about ReportingCloud at:

• ReportingCloud web site

• ReportingCloud portal - sign up here

• ReportingCloud documentation

Learn more about ReportingCloud PHP SDK at:

• ReportingCloud PHP SDK GitHub page

• ReportingCloud PHP SDK Packagist page

• ReportingCloud PHP SDK API documentation

• ReportingCloud PHP SDK support

Minimum Requirements

Since ReportingCloud PHP SDK 3.0, the PHP SDK requires PHP 7.4 or PHP 8.0.

All versions of PHPs prior to 7.3 have reached end-of-life and consequently, no further security updates will be released for them. If your application is running in an older environment, it is highly advisable to update to a more current version of PHP.

If you are unable or unwilling to update your PHP installation, you may consider using ReportingCloud PHP SDK 2.0, which supports PHP 7.1, or ReportingCloud PHP SDK 1.0, which supports PHP 5.6.

Please note, however, these versions are no longer maintained.

Alternatively, it is possible to use ReportingCloud by directly accessing the Web API. In such cases, it is advisable to use the curl extension to make the API calls.

Install Using Composer

Install ReportingCloud PHP SDK 3.0 in your project using Composer:

composer require textcontrol/txtextcontrol-reportingcloud:^3.0

After installing, you just need to include Composer's autoloader:

include_once 'vendor/autoload.php';

You are now ready to use the SDK.

API Key for Demos and Unit Tests

ReportingCloud PHP SDK ships with a number of sample applications (see directory /demo) and phpunit tests (see directory /test). The scripts in each of these directories require an API key for ReportingCloud in order to be executed. So that the API key is not made inadvertently publicly available via a public GIT repository, you will first need to specify it. There are two ways in which you can do this:

Using PHP Constants:

define('REPORTING_CLOUD_API_KEY', 'your-api-key');

Using Environmental Variables (For Example in .bashrc)

export REPORTING_CLOUD_API_KEY='your-api-key'

Note, these instructions apply only to the demo scripts and phpunit tests. When you use ReportingCloud in your application, set the API key in your constructor or by using the setApiKey($apiKey) methods. For an example, see /demo/instantiation.php.

Getting Started

The PHP Quickstart Tutorial in the ReportingCloud documentation is your starting point to using ReportingCloud PHP SDK in your own applications.

In addition, ReportingCloud PHP SDK ships with a number of sample applications (see directory /demo). These samples applications, which are well commented, have been written to demonstrate all parts of ReportingCloud.

Getting Support

The ReportingCloud PHP SDK is authored and supported by Text Control GmbH, the manufacturer of the ReportingCloud Web API.

Despite our best efforts to create understandable documentation, demo applications and unit tests, we understand that there are times when you may need some technical assistance.

If you have a question about ReportingCloud or the PHP SDK, we want to help you.

Please refer to the Getting Support section of the ReportingCloud documentation to learn more about the support channels at your disposition.