davidcao626/suning-sdk

suning sdk for composer package

0.0.1 2018-10-01 16:02 UTC

Requires

• php: >=7.1

Requires (Dev)

• phpunit/phpunit: ^6.5

MIT

• DavidCao626

README

基于苏宁开放平台SDK（PHP）封装的 Composer Package 组件包.

安装：

$ composer require davidcao626/suning-sdk -vvv

说明:

目前只完成了政企业务(govbus)API封装 官方文档

其他官方功能API 添加封装方法 参考 /src/Request/govbus/ 下的实现

使用方法:

use DavidCao626\SuningSdk\Request\Govbus\CategoryGetRequest;
use DavidCao626\SuningSdk\DefaultSuningClient;

$req = new CategoryGetRequest();
$req->setCheckParam('true');
$assertArray = [
    'serverUrl' => 'http://openpre.cnsuning.com/api/http/sopRequest',
    'appKey' => 'xxxxxxxxxxxxxxxxxxxxxxxx',
    'appSecret' => 'xxxxxxxxxxxxxxxxxxxxxxxx',
    'format' => 'json'
];
$client = new DefaultSuningClient($assertArray['serverUrl'], $assertArray['appKey'],
    $assertArray['appSecret'], $assertArray['format']);

$resp = $client->execute($req);
$reqJson = $req->getReqJson();
print_r("请求报文:\n" . $reqJson);
print_r("\n返回响应报文:\n" . $resp);

##laravel 框架中使用

laravel 5.5以下安排完毕后需要自行配置ServiceProvider：

config/app.php文件providers中添加 DavidCao626\SuningSdk\ServiceProvider::class

 'providers' => [
        ...
        DavidCao626\SuningSdk\ServiceProvider::class
    ],

laravel >=5.5 自动注册

1.安装完毕后，config/services.php添加appkey等相关配置

'suningSdk' => [
    'appKey' => env('SUNING_SDK_APPKEY'),
    'appSecret' => env('SUNING_SDK_APPSECRET'),
    'serverUrl' => env('SUNING_SDK_SERVERURL'),
    'format' => env('SUNING_SDK_FORMAT'),
],

2. .env文件中新增配置项

SUNING_SDK_APPKEY= 你的appkey
SUNING_SDK_APPSECRET= 你的appSecret
SUNING_SDK_SERVERURL=http://openpre.cnsuning.com/api/http/sopRequest
SUNING_SDK_FORMAT=json

3. 配置完毕，新建控制器 开始写业务代码

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use DavidCao626\SuningSdk\Request\Govbus\CategoryGetRequest;
use DavidCao626\SuningSdk\DefaultSuningClient;

class CategoryGet extends Controller
{
    public function show(Request $request)
    {

        $req = new CategoryGetRequest();

        $req->setCheckParam('true');
        $resp =app('suningSdk')->execute($req);
        $reqJson = $req->getReqJson();
        print_r("请求报文:\n" . $reqJson);
        print_r("\n返回响应报文:\n" . $resp);
        $request->json($resp);
    }
}

如上，可以用两种方式来获取 DavidCao626\SunningSdk\DefaultSuningClient 实例：

##方法注入

    public function show(DefaultSuningClient $defaultSuningClient) 
    {
        ...
        $response = $defaultSuningClient->execute('$req');
    }

##服务名访问

    public function show() 
    {
        ...
        $response =app('suningSdk')->execute($req);
    }

相关链接

苏宁开放平台-SDK下载介绍

Contributing

You can contribute in one of three ways:

1. File bug reports using the issue tracker.
2. Answer questions or fix bugs on the issue tracker.
3. Contribute new features or update the wiki.

The code contribution process is not very formal. You just need to make sure that you follow the PSR-0, PSR-1, and PSR-2 coding guidelines. Any new code contributions must be accompanied by unit tests where applicable.

License

Apache Licence 2.0