Skip to content

Worldline-Global-Collect/connect-sdk-php

Repository files navigation

Worldline Connect PHP SDK

Introduction

The Worldline Connect PHP SDK helps you to communicate with the Worldline Connect Server API. Its primary features are:

  • convenient PHP wrapper around the API calls and responses:
    • marshalls PHP request objects to HTTP requests
    • unmarshalls HTTP responses to PHP response objects or PHP exceptions
  • handling of all the details concerning authentication
  • handling of required metadata

Its use is demonstrated by an example for most calls. The examples execute a call using the provided API keys.

See the Worldline Connect Developer Hub for more information on how to use the SDK.

Structure of this repository

This repository consists out of the following components:

  1. The source code of the SDK itself: /src and /lib
  2. The source code of the unit and integration tests (including the examples): /tests

Requirements

PHP 5.4 or above is required. In addition, to support streaming uploads, package robtimus/multipart is required.

Installation via Composer

  1. Initialize Composer in your project, if this is not already done, by executing the following command:

    composer init
    
  2. Add a requirement to the SDK to your composer.json file by executing the following command:

    composer require worldline-global-collect/connect-sdk-php
    
  3. Add vendor/autoload.php to your project, if this is not already done, by adding the following line of code:

    require __DIR__ . '/vendor/autoload.php';
    

Manual installation

  1. Download the latest version of the PHP SDK from GitHub. Choose the connect-sdk-php-x.y.z.tar.gz file from the releases page, where x.y.z is the version number.
  2. Add the contents of the tar.gz file to your project. The content of the /src and /lib folders may be combined, if this is required by the project.
  3. Add all classes from the /src and /lib folders to your autoloader; all classes inside these folders are compliant with PSR-4.

Development and testing

  1. Install Composer
  2. From the root of the sdk-php project, run composer install
  3. Copy tests/config.json.dist to tests/config.json and replace the template values by actual values
  4. From the root of the sdk-php project, vendor/phpunit/phpunit/phpunit (or just phpunit when it is already installed on your local machine)