2017 © Pedro Peláez
 

library yundunsdk

image

yundun/yundunsdk

  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 6 Versions
  • 7 % Grown

The README.md

Build Status Latest Stable Version Total Downloads Latest Unstable Version License Monthly Downloads Daily Downloads, (*1)

YUNDUN API PHP SDK legend

  • 接口基地址: 'http://apiv4.yundun.cn/V4/';
  • 接口遵循RESTful,默认请求体json,接口默认返回json
  • app_id, app_secret 联系技术客服,先注册一个云盾的账号,用于申请绑定api身份, (*2)

  • 签名, (*3)

    • 每次请求都签名,保证传输过程数据不被篡改
    • 客户端:sha256签名算法,将参数base64编码+app_secret用sha256签名,每次请求带上签名
    • 服务端:拿到参数用相同的算法签名,对比签名是否正确
  • 环境要求:php >=5.5, (*4)

  • 依赖composer

使用步骤

  1. composer require yundun/yundunsdk, (*5)

  2. 实例化, (*6)

    //sdk
    require 'xx/vendor/autoload.php';
    $app_id = 'xx';
    $app_secret = 'xx';
    $client_ip = 'xx';
    $client_userAgent = '';
    $base_api_url = 'http://apiv4.yundun.cn/V4/';
    ;base_api_url = 'http://127.0.0.1/V4/'
    $host = 'apiv4.yundun.cn';
    $handler = 'guzzle'; //curl/guzzle默认guzzle,guzzle支持异步调用,curl驱动目前未实现异步
    $sdk = new YundunSDK (
        [
        'app_id'=>$app_id, 
        'app_secret'=>$app_secret, 
        'base_api_url' = 'http://127.0.0.1/V4/',
        'host' => 'apiv4.xx.cn',
        'client_ip'=>$client_ip, 
        'client_userAgent'=>$client_userAgent, 
        'handler'=> $handler,
        'syncExceptionOutputCode' => 0,
        'syncExceptionOutputMessage' =>'同步请求异常信息提示',
        'asyncExceptionOutputCode' => 0,
        'asyncExceptionOutputMessage' => '异步请求异常信息提示'
        'log' => true,  //是否记录sdk相关日志
        'logfileWin' => 'E:/sdkV4.log', //windows日志路径
        'logfileLinux' => '/tmp/sdkV4.log' //linux日志路径
        ]
    );

  1. 调用

format json返回json,xml返回xml, (*7)

body 支持传递json和数组, (*8)

urlParams会拼接在url后面, (*9)

支持get/post/patch/put/delete方法, (*10)

sync request

  • get

$request = array( 'url' => 'api/version', 'body' => '', 'headers' => [ 'format' => 'json', ], 'timeout' => 10, 'query' => [ 'params1' => 1, 'params2' => 2 ], ); try{ $res = $sdk->get($request); }catch (\Exception $e){ var_dump($e->getCode()); var_dump($e->getMessage()); } exit($res);
  • post/put/patch/delete

$request = array( 'url' => 'api/version', 'body' => json_encode([ 'body1' => 1, 'body2' => 2, ]), 'headers' => [ 'format' => 'json', ], 'timeout' => 10, 'query' => [ 'params1' => 1, 'params2' => 2 ], ); try{ $res = $sdk->post($request); }catch (\Exception $e){ var_dump($e->getCode()); var_dump($e->getMessage()); } exit($res);

async request

  • get

$request = array( 'url' => 'api/version', 'body' => '', 'headers' => [ 'format' => 'json', ], 'timeout' => 10, 'query' => [ 'params1' => 1, 'params2' => 2 ], 'options' => [ 'async' => true, 'callback' => function($response){ $body = $response->getBody->getContents(); echo $body; exit; }, 'exception' => function($exception){} ] ); try{ $sdk->getAsync($request); }catch (\Exception $e){ var_dump($e->getCode()); var_dump($e->getMessage()); }
  • post/put/patch/delete

$request = array( 'url' => 'api/version', 'body' => json_encode([ 'body1' => 1, 'body2' => 2, ]), 'headers' => [ 'format' => 'json', ], 'timeout' => 10, 'query' => [ 'params1' => 1, 'params2' => 2 ], 'options' => [ 'async' => true, 'callback' => function($response){ $body = $response->getBody->getContents(); echo $body; exit; }, 'exception' => function($exception){} ] ); try{ $sdk->postAsync($request); }catch (\Exception $e){ var_dump($e->getCode()); var_dump($e->getMessage()); }

The Versions

02/08 2018

1.x-dev

1.9999999.9999999.9999999-dev

  Sources   Download

26/04 2018

dev-master

9999999-dev

YUNDUN SDK

  Sources   Download

The Requires

 

The Development Requires

16/10 2017

v1.0.3

1.0.3.0

YUNDUN SDK

  Sources   Download

The Requires

 

25/07 2017

v1.0.2

1.0.2.0

YUNDUN SDK

  Sources   Download

The Requires

 

20/07 2017

v1.0.1

1.0.1.0

YUNDUN SDK

  Sources   Download

The Requires

 

24/02 2017

v1.0.0

1.0.0.0

YUNDUN SDK

  Sources   Download

The Requires