Download the PHP package rips/connector without Composer
On this page you can find all versions of the php package rips/connector. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package connector
RIPS Connector
A simple PHP interface for easy access to the RIPS API.
Installation
Use composer to include the package:
composer require rips/connector:~3.4
OR add the following to composer.json and run composer update
"rips/connector": "~3.4"
Usage
use RIPS\Connector\API;
use RIPS\Connector\Exceptions\ClientException;
use RIPS\Connector\Exceptions\ServerException;
$config = ['base_uri' => 'http://localhost:8000'];
// Initialize with config in constructor
$api = new API('email', 'password', $config);
// Or initialize manually
$api = new API();
$api->initialize('email', 'password', $config);
try {
// Get all users
$users = $api->users->getAll()->getDecodedData();
// Create new organization
$org = $api->orgs->create([
'name' => 'My New Org',
'validUntil' => '2018-08-03T15:23:04.286Z'
]);
} catch (ClientException $e) {
// 400 error
} catch (ServerException $e) {
// 500 error
}
Most methods will return a Response
object. To get the actual data call the method getDecodedData()
.
This returns either a stdClass
object or an array of stdClass
objects.
Config/Options
The following config options are available:
'base_uri' (required, default: http://localhost:8080): API URL
'timeout' (optional, default: 100): Timeout of request in seconds
'connect_timeout' (optional, default: 10): Number of seconds to wait while trying to connect to server
'oauth2' (optional): OAuth2 configuration, see OAuth2 Config
OAuth2Config
The following options are available as associative array under the oauth2 key:
'enabled' (required): Use OAuth2 instead of legacy auth
'client_id' (required): Client id for the login client
'store_token' (optional, default: false): Flag if the OAuth2 tokens should be stored on disk
'token_file_path' (optional): The file location for the token file
'access_token' (optional, default: ""): If already present a accesstoken to use for login
Testing
Testing is done with phpunit. You can install phpunit globally or use the composer installed executable in vendor/bin/phpunit
.
Abstract classes use stubs found in test/Stubs.
Run the tests by executing phpunit in the root directory of the project:
With global install:
phpunit
With composer install:
vendor/bin/phpunit