ledevoir/pianoid-api-php-sdk

The unofficial PHP SDK for PianoID API

0.11.0 2023-09-27 14:07 UTC

Requires

• php: >=8.2
• ext-json: *
• guzzlehttp/guzzle: ^7

Requires (Dev)

• phpunit/phpunit: ^10

MIT

• Philippe bourdeau

README

The unofficial PHP SDK for PianoID API

Documentation

https://docs.piano.io/piano-id-api

Install the library

composer require ledevoir/pianoid-api-php-sdk

Configuration requirements

Configure the following environment variables (must be set in $_ENV[] variable) or configure values manually in the Environment object

PIANO_ID_API_BASE_URL='www.whatever.com'
PIANO_APPLICATION_ID='valid_application_id'
PIANO_API_TOKEN='VERY_SECURE_TOKEN'

Usage example

use \LeDevoir\PianoIdApiSDK\Client\GuzzleClient;
use \LeDevoir\PianoIdApiSDK\Request\Login\LoginRequest;

$client = new GuzzleClient();
$request = new LoginRequest('[e-mail]', 'password');

$httpResponse = $client->send($request);
$pianoResponse = $request->toPianoIdResponse($httpResponse);

$failed = $pianoResponse->isFailure();

Tests

To debug unit tests

 XDEBUG_TRIGGER=yes vendor/bin/phpunit tests

Future outlook / TODO

• Might consider guzzle interfaces and main classes (request, response & client integration further ?)
• Consider removing guzzle client and replacing with cURL client or add client interface and provide both options