PHP SDK 入门
本页内容
在自己的服务端使用 PHP SDK 调用开放 API。按本教程下载源码、配置凭据并运行一个只读请求,确认接入后再继续上传、签名或分发。
运行环境与下载
准备 8.3+,启用 ext-curl。下载PHP 源码包,核对包内 SHA256SUMS。需要固定接入版本时,保存所用源码包及其独立摘要。
准备项目
在私有目录解压,将入口保存为 example.php。保留包内相对位置,不把源码目录和运行入口拆散。
示例直接 require cloudsign-sdk/php/Client.php,不要求先从 Composer 公共仓库安装。项目使用 Composer 时,可按包内配置以本地 path 方式集成。
配置凭据
| 变量 | 填写方式 |
|---|---|
CLOUDSIGN_BASE_URL | https://www.onesignios.com,完整 HTTPS 网站来源,不带 API 路径。 |
CLOUDSIGN_ACCESS_KEY_ID | 自己的 AccessKey ID。 |
CLOUDSIGN_ACCESS_KEY_SECRET | 对应 Secret,从服务端安全配置注入。 |
CLOUDSIGN_SECURITY_TOKEN | 临时凭据使用同一组令牌;长期凭据不填写。 |
本页先运行只读请求。需要写入时,再按幂等键准备说明配置对应业务,并核对所需权限。
运行只读示例
将下面代码保存为指定入口,再运行命令。SDK 正常返回后,从 data 核对账号、动作和应用范围,并保存 request_id 供排查。错误响应也包含请求 ID,不能仅凭它判断成功。响应约定见请求与响应约定。
<?php
declare(strict_types=1);
// Extract the PHP SDK source ZIP beside this file. Keep credentials on your server.
require_once __DIR__ . '/cloudsign-sdk/php/Client.php';
$requiredEnv = static function (string $name): string {
$value = getenv($name);
if ($value === false || $value === '') { throw new RuntimeException('Missing environment variable'); }
return $value;
};
try {
$client = new \Cloudsign\Sdk\Client(
$requiredEnv('CLOUDSIGN_BASE_URL'),
$requiredEnv('CLOUDSIGN_ACCESS_KEY_ID'),
$requiredEnv('CLOUDSIGN_ACCESS_KEY_SECRET'),
getenv('CLOUDSIGN_SECURITY_TOKEN') ?: '',
);
$result = $client->getIdentity();
echo $result['request_id'], PHP_EOL;
} catch (\Cloudsign\Sdk\ApiError $error) {
fwrite(STDERR, 'HTTP ' . $error->status . ' ' . $error->apiCode . '; RequestId: ' . $error->requestId . PHP_EOL);
exit(1);
} catch (Throwable $error) {
fwrite(STDERR, "Check SDK path, runtime and environment variables.\n");
exit(1);
}
php example.php确认调用结果
示例正常运行后会输出请求标识。先确认程序没有抛出 SDK 或 HTTP 错误,再按下表读取成功响应,核对您实际接入的账号和资源范围。
| 字段 | 怎样理解 | 需要确认 |
|---|---|---|
request_id | 本次调用的请求标识。 | 保存用于排查;错误响应也可能有这个字段。 |
data.owner_id | 当前凭据所属的平台账号。 | 应是准备接入的本人账号。 |
data.actions | 当前身份可使用的授权动作。 | 包含下一步所需的读取或写入动作。 |
data.resources | 当前授权的应用范围。 | 覆盖准备操作的自有业务应用。 |
示例只输出请求标识时,按本语言的响应读取方式取得上述字段,不需要把完整响应或 Secret 写入日志。概念与 ID 的区别见基本概念;C 字段读取见强类型响应。
接入业务
从企业签名或应用分发开始。每个接口页均提供对应语言调用,替换为自己的真实 ID,并按先查询、再确认、后写入的业务顺序执行。
SDK 的本地输入检查不能代替服务器授权。上传、签名和付款各自确认结果;网络中断先恢复原操作。
需要组合多次调用时,请阅读上传、等待与下载助手;更新源码包前,请按升级前准备保存正在处理的任务。
常见问题
导入失败先检查目录与运行环境;401 检查凭据、网站主域名和时钟;403 / 404 检查账号及应用范围。不要把完整 Secret、短期 URL 或原始敏感响应输出到日志。