README

Sarus SDK for PHP

安装

安装 riselms/sarus-sdk-php 的推荐方法是 通过 composer。

composer require riselms/sarus-sdk-php

使用

不要忘记自动加载

<?php
require 'vendor/autoload.php';

初始化 Sdk 对象

use Sarus\SdkFactory;
use Sarus\Config;

$config = new Config(
   'SECRET',               // Requred  - API secret for sarus    
   'https://api.sarus.io', // Optional - base url
   30,                     // Optional - timeout
   true                    // Optional - ssl verify
);
//OR
$config = Config::fromArray([
   'secret'    => 'SECRET',               // Requred  - API secret for sarus    
   'baseUri'   => 'https://api.sarus.io', // Optional - base url
   'timeout'   => 30,                     // Optional - timeout
   'sslVerify' => true                    // Optional - ssl verify
]);
$factory = new SdkFactory();
$sdk = $factory->create($config);
 
// If you want to log request and response:
 $logger = new Logger(); //class implemented \Psr\Log\LoggerInterface
 $logFormat = \GuzzleHttp\MessageFormatter::CLF; \\Formating of log message
 $logLevel = \Psr\Log\LogLevel::INFO; //By default log level is info
 $sdk = $factory->createWithLogger($config, $logger, $logFormat, $logLevel);

ping 并检查认证密钥

try {

    $sdk->ping();

} catch (\Sarus\Client\Exception\HttpException $e) {
}

购买产品

$sarusProductUuids = ['uuid1', 'uuid2'];
$user = new \Sarus\User(
    'test@test.com',
    'test_name',
    'test-last_name',
    96
);
$user
    ->setCity('Milwaukee')
    ->setCountry('USA')
    ->setRegion('Wisconsin')
    ->setAddress1('53 Creek Lane')
    ->setPostalCode('53204')
;
try {

    $sdk->purchaseProduct($sarusProductUuids, $user);

} catch (\Sarus\Client\Exception\HttpException $e) {
}

解除产品链接

$sarusPoductUuid = 'uuid1';
try {

    $sdk->unlinkProduct($sarusPoductUuid);

} catch (\Sarus\Client\Exception\HttpException $e) {
}

获取用户已报名的课程列表

$email = 'testemal@user.com';
try {

    $response = $sdk->listEnrollments($email);
    
    foreach($response->get('data') as $enrollment) {
        $enrollment['course_uuid'];
        $enrollment['title'];
        $enrollment['description'];
        $enrollment['image_src'];
        $enrollment['url'];
    }

} catch (\Sarus\Client\Exception\HttpException $e) {
}

取消用户报名

$email = 'testemal@user.com';
$sarusPoductUuids = ['uuid1', 'uuid2'];
try {

    $sdk->deactivateEnrollments($email, $sarusPoductUuids);

} catch (\Sarus\Client\Exception\HttpException $e) {
}

通过 handleRequest 方法运行任何请求

$request = \Sarus\Request\CustomRequest::fromArray([
    'path'   => '/v1/ping',
    'method' => 'GET',
    'body'   => null,
]);

try {

    $resposne = $sdk->handleRequest($request);

} catch (\Sarus\Client\Exception\HttpException $e) {
}

请求序列化

$request = \Sarus\Request\CustomRequest::fromArray([
    'path'   => '/v1/ping',
    'method' => 'GET',
    'body'   => null,
]);

$serialized = serialize($request);
$unserializedRequest = unserialize($serializaed);

请求转换

• json

$request = \Sarus\Request\CustomRequest::fromArray([
    'path'   => '/v1/ping',
    'method' => 'GET',
    'body'   => null,
]);

$serialized = \json_encode($request);

$data = \json_decode($serialized, true);
$unserializedRequest = \Sarus\Request\CustomRequest::fromArray($data);

• 数组

$request = \Sarus\Request\CustomRequest::fromArray([
    'path'   => '/v1/ping',
    'method' => 'GET',
    'body'   => null,
]);

$serialized = $request->toArray();
$unserializedRequest = \Sarus\Request\CustomRequest::fromArray($data);

可从 Sarus\Client\Exception\HttpException 中获取的信息

try {

// request

} catch (\Sarus\Client\Exception\HttpException $e) {
    // The exceptions is thrown if http request is not successful

    $e->getMessage();           // returns either grabbed message from response body or reason phrase
    $e->hasResponse();          // returns bool, if exception holds response object
    $e->getResponse();          // returns \Psr\Http\Message\ResponseInterface
    $e->getRequest();           // returns  \Psr\Http\Message\RequestInterface
}

运行测试

• 运行命令 bin/phpunit