PHPackages                             zacksleo/suning-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. zacksleo/suning-sdk

ActiveLibrary[API Development](/categories/api)

zacksleo/suning-sdk
===================

苏宁SDK

1.0.0(6y ago)324MITPHP

Since Jul 23Pushed 6y agoCompare

[ Source](https://github.com/zacksleo/suning-sdk)[ Packagist](https://packagist.org/packages/zacksleo/suning-sdk)[ RSS](/packages/zacksleo-suning-sdk/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

 suning-sdk
============

[](#-suning-sdk-)

 苏宁开放平台 SDK

Installing
----------

[](#installing)

```
$ composer require zacksleo/suning-sdk -vvv
```

Usage
-----

[](#usage)

### 1. 初始化客户端

[](#1-初始化客户端)

```
use Zacksleo\SuningSdk\Suning;

$suning = new Suning([
    'key'        => 'key',
    'secret'     => 'secret',
    'debug'      => false,
    'log' => [
        'file'       => __DIR__.'/suning.log',
        'level'      => 'error',
        'permission' => 0777,
    ]
]);
```

### 2.1 链式调用方式

[](#21-链式调用方式)

> 该方式支持类型提示和自动补全

```
$response = $suning->custom->logisticcompany->get(['companyName' => '申通快递',]);
```

### 2.2 标准调用方式

[](#22-标准调用方式)

```
$response = $suning->request([
    'suning.custom.logisticcompany.get' => 'logisticCompany'
], [
    'companyName' => '申通快递',
]);
```

> 第一个参数如果是数组，key 为 ApiMethodName, value 为 BizName。第二个参数对应[官方文档示例中](http://open.suning.com/ospos/apipage/toApiListMenu.do) 请求参数的值

以上调用可省略为

```
$response = $suning->request('suning.custom.logisticcompany.get', [ 'companyName' => '申通快递' ]);
```

或

```
$response = $suning->request('custom.logisticcompany.get', [ 'companyName' => '申通快递', ]);
```

> 注意：除标准调用方式外，其他调用方式需要确保 [map.php](https://github.com/zacksleo/suning-sdk/blob/master/src/map.php) 文件中存在对应的值。如果没有，欢迎PR.

### 输出格式

[](#输出格式)

返回值取出的是 sn\_header 及 sn\_body, 如果不存在 sn\_header， 给给予默认值

```
array:2 [
  "header" => array:4 [
    "pageTotal" => 1
    "pageNo" => 1
    "totalSize" => 1
    "returnMessage" => ""
  ]
  "body" => array:2 [
    "expressCompanyName" => "申通快递"
    "expressCompanyCode" => "S01"
  ]
]
```

### 异常处理

[](#异常处理)

```
try {
    $response = $suning->custom->logisticcompany->get([
        'companyName' => '申通快递',
    ]);
} catch (\Exception $exception) {
    var_dump($exception->getMessage());
}
```

命令行工具
-----

[](#命令行工具)

### 生成 map.php 文件

[](#生成-mapphp-文件)

```
php ./bin/suning map:generate
```

### 生成 fake:generate 用的 map-fake.php 文件

[](#生成-fakegenerate-用的-map-fakephp-文件)

```
php ./bin/suning map:generate --fake
```

### 生成用于代码补全提示的类

[](#生成用于代码补全提示的类)

```
php ./bin/suning fake:generate
```

Contributing
------------

[](#contributing)

You can contribute in one of three ways:

1. File bug reports using the [issue tracker](https://github.com/zacksleo/suning-sdk/issues).
2. Answer questions or fix bugs on the [issue tracker](https://github.com/zacksleo/suning-sdk/issues).
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
-------

[](#license)

MIT

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity10

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2486d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3e97b8a6f67b09513e345a128d73a63898ae1ec9f6a6c77234c78b3f16d305d1?d=identicon)[zacksleo](/maintainers/zacksleo)

---

Top Contributors

[![zacksleo](https://avatars.githubusercontent.com/u/3369169?v=4)](https://github.com/zacksleo "zacksleo (28 commits)")

---

Tags

php7sdksuningsuning-sdk

### Embed Badge

![Health badge](/badges/zacksleo-suning-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/zacksleo-suning-sdk/health.svg)](https://phpackages.com/packages/zacksleo-suning-sdk)
```

###  Alternatives

[justmd5/pinduoduo-sdk

拼多多API SDK【拼多多开放平台】.

23514.1k1](/packages/justmd5-pinduoduo-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)