PHP

最近更新时间：2019-03-05 17:37:24

在这篇文章中：

简介

欢迎使用SDK开发者工具套件（SDK）3.0，SDK3.0 是SDK API3.0 平台的配套工具。目前已经支持 cvm、vpc、cbs 等产品，后续所有的SDK服务产品都会接入进来。新版 SDK 实现了统一化，具有各个语言版本的 SDK 使用方法相同，接口调用方式相同，统一的错误码和返回包格式这些优点。
为方便 PHP 开发者调试和接入SDK产品 API，这里向您介绍适用于 PHP 的SDK开发工具包，并提供首次使用开发工具包的简单示例。让您快速获取SDK PHP SDK 并开始调用。

支持 3.0 版本的产品列表

SDK3.0支持全部 API3.0下的产品，本列表可能滞后于实际代码，如有疑问请咨询具体的产品。

SDK服务器	黑石物理服务器	SDK硬盘	容器服务
容器实例服务	弹性伸缩	无服务器SDK函数	批量计算
负载均衡	私有网络	专线接入	SDK数据库 MySQL
SDK数据库 Redis	SDK数据库 MongoDB	数据传输服务 DTS	SDK数据库 MariaDB
分布式数据库 DCDB	SDK数据库 SQL Server	SDK数据库 PostgreSQL	内容分发网络
主机安全	Web 漏洞扫描	应用安全	SDK点播
SDK直播	智能语音服务	机器翻译	智能钛机器学习
催收机器人	智聆口语评测	SDK优评	SDK优Mall
物联网通信	TBaaS	SDK监控	迁移服务平台
电子合同服务	计费相关	渠道合作伙伴	人脸核身-SDK智慧眼
威胁情报SDK查	样本智能分析平台	数学作业批改	人脸融合
人脸识别	数字版权管理	Elasticsearch Service

API Explorer

API Explorer 提供了在线调用、签名验证、 SDK 代码生成和快速检索接口等能力，能显著降低使用SDK API 的难度，推荐使用。

依赖环境

PHP 5.6.33 版本及以上。
从SDK 控制台开通相应产品。
获取 SecretID、SecretKey 以及调用地址（endpoint），endpoint 一般形式为 *.tencentcloudapi.com，如 CVM 的调用地址为 cvm.tencentcloudapi.com，具体参考各产品说明。

获取安装

安装 PHP SDK 前，先获取安全凭证。在第一次使用SDK API 之前，用户首先需要在SDK控制台上申请安全凭证，安全凭证包括 SecretID 和 SecretKey， SecretID 是用于标识 API 调用者的身份，SecretKey 是用于加密签名字符串和服务器端验证签名字符串的密钥。SecretKey 必须严格保管，避免泄露。

通过 Composer 安装

通过 Composer 获取安装是使用 PHP SDK 的推荐方法，Composer 是 PHP 的依赖管理工具，支持您项目所需的依赖项，并将其安装到项目中。关于 Composer 详细可参考 Composer 官网。

安装 Composer：
windows 环境请访问 Composer官网下载安装包安装。
unix 环境在命令行中执行以下命令安装。
```
curl -sS
                                                    https://getcomposer.org/installer | php
```
在 composer.json 的 require 结构体中加入依赖：注意这里的版本号只是举例，您可以在 composer 仓库上看到最新的版本号。
```
"tencentcloud/tencentcloud-sdk-php":
                                                    "3.0.*"
```
运行 composer install 下载安装 PHP SDK。
添加以下引用代码，引用方法可参考示例。
```
require 'vendor/autoload.php';
```

通过源码包安装

前往 Github 代码托管地址或者快速下载地址下载源码压缩包。
解压源码包到您项目合适的位置。
添加以下引用代码，引用方法可参考示例。
```
require_once '../TCloudAutoLoader.php';
```

示例

以查询可用区接口为例:

<?php
    require_once '../../../TCloudAutoLoader.php';
    // 导入对应产品模块的client
    use TencentCloud\Cvm\V20170312\CvmClient;
    // 导入要请求接口对应的Request类
    use TencentCloud\Cvm\V20170312\Models\DescribeZonesRequest;
    use TencentCloud\Common\Exception\TencentCloudSDKException;
    use TencentCloud\Common\Credential;
    try {
    // 实例化一个证书对象，入参需要传入SDK账户secretId，secretKey
    $cred = new Credential("secretId", "secretKey");

    // # 实例化要请求产品(以cvm为例)的client对象
    $client = new CvmClient($cred, "ap-guangzhou");

    // 实例化一个请求对象
    $req = new DescribeZonesRequest();

    // 通过client对象调用想要访问的接口，需要传入请求对象
    $resp = $client->DescribeZones($req);

    print_r($resp->toJsonString());
    }
    catch(TencentCloudSDKException $e) {
    echo $e;
    }

旧版 SDK

旧版本的 SDK 存放于 QcloudApi 目录，详细使用说明请到旧版 PHP SDK，但不再维护更新，推荐使用新版 SDK。

下一篇: Python

PHP