README

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

安装：

$ 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下载介绍

贡献

您可以通过以下三种方式之一进行贡献：

1. 使用 问题追踪器 提交错误报告。
2. 在 问题追踪器 上回答问题或修复错误。
3. 贡献新功能或更新 wiki。

代码贡献过程并不非常正式。您只需确保遵循 PSR-0、PSR-1 和 PSR-2 编码指南。任何新的代码贡献都必须附带相应的单元测试（如果适用）。

许可证

Apache 许可证 2.0