有赞SDK使用教程

1. 项目介绍

有赞SDK是为开发者提供的一种方便对接有赞平台接口的工具，它支持PHP语言，旨在简化与有赞云服务的交互过程。SDK包含了获取及刷新access_token的功能，可用于创建和管理有赞店铺相关的业务数据。

2. 项目快速启动

2.1 安装

通过Composer进行安装：

composer require youzanyun/open-sdk-php

若项目不使用Composer管理，可下载ZIP压缩包并手动引入：

1. 下载最新release。
2. 解压缩到你的项目目录。
3. 在项目中引入autoload.php：

require_once '/YOUR_SDK_PATH/youzanyun-open-sdk/open-sdk/vendor/autoload.php';

请将/YOUR_SDK_PATH/替换为SDK的实际路径。

2.2 示例代码

以下是一个简单的访问有赞API的例子：

<?php
// 初始化配置
$youzan = new \YouZan\Open\SDK([
    'client_id'     => 'YOUR_CLIENT_ID',
    'client_secret' => 'YOUR_CLIENT_SECRET',
    'debug'         => true,
    'kdt_id'        => '', // 若为自用型应用，请填写店铺ID
]);

// 获取订单
$result = $youzan->request('youzan.trade.get', ['tid' => 'ORDER_ID']);

// 检查响应
if ($result['code'] === 0) {
    echo '订单信息：' . json_encode($result['data'], JSON_PRETTY_PRINT);
} else {
    echo '请求失败：' . $result['msg'];
}

别忘了替换YOUR_CLIENT_ID, YOUR_CLIENT_SECRET 和 ORDER_ID为你自己的值。

3. 应用案例和最佳实践

• 调试模式：在开发阶段开启debug模式，有助于调试API调用中的错误。
• 日志记录：配置log参数来保存SDK的日志，便于排查问题。
• 版本控制：可以根据需求设置API的版本号，如setVersion('4.0.0')来使用特定版本的服务。

4. 典型生态项目

除了基础SDK外，还有其他相关项目可供选择：

• 有赞云网关SDK：与本SDK类似，用于处理有赞云服务的通用接口。
• Hanson/youzan-sdk：由第三方维护的PHP实现，支持有赞云的多个版本，可以作为扩展选项。

以上就是有赞SDK的基本介绍和使用指南。进一步了解和使用，建议阅读项目文档和示例代码。祝你在使用过程中一切顺利！