PHP SDK：PHP SDK使用说明

简介


欢迎使用阿里云开发者工具套件（SDK）。阿里云 PHP SDK 让您不用复杂编程即可访问云服务器、云监控等多个阿里云服务。这里向您介绍如何获取阿里云 PHP SDK 并开始调用。

环境准备

1. 
   阿里云 PHP SDK 适用于 PHP 的 5.3，5.4，5.5，5.6，7.0和7.1版本。（您可以通过命令php -v来获得当前使用的 PHP 版本号。）
2. 
   要使用阿里云 PHP SDK，您需要一个云账号以及一对Access Key ID和Access Key Secret。请在阿里云控制台中的 AccessKey 管理页面上创建和查看您的Access Key，或者联系您的系统管理员。
3. 
   要使用阿里云 SDK 访问某个产品的 API，您需要事先在阿里云控制台中开通这个产品。

SDK 获取和安装


进入 阿里云 PHP SDK。
请注意，部分阿里云产品的 SDK 未收录到这个列表中，例如对象存储（OSS），表格存储（Table Store），请前往这些产品的详情页获取相应的 SDK。
现在，我们暂时只支持一种方式来获取和使用 PHP SDK：

方式一：源码引用方式


首先从 GitHub 上下载 PHP SDK 的源代码：

1. git clone https://github.com/aliyun/aliyun-openapi-php-sdk.git

假设 PHP SDK 下载后的路径为/path/to/aliyun-openapi-php-sdk。然后在您的代码文件中加上对 PHP SDK 的引用：

1. require_once '/path/to/aliyun-openapi-php-sdk/aliyun-php-sdk-core/Config.php';

之后便可在您的代码中开始调用阿里云 PHP SDK。

开始调用


以下这个代码示例向您展示了调用阿里云 SDK 的 3 个主要步骤：

1. 创建 DefaultAcsClient 实例并初始化；
2. 创建 API 请求并设置参数；
3. 发起请求并处理返回。

1. <?php
3. use Ecs\Request\V20140526\DescribeInstancesRequest;
5. # 创建 DefaultAcsClient 实例并初始化
7. $clientProfile = DefaultProfile::getProfile(
8.     "<your-region-id>",                   # 您的 Region ID
9.     "<your-access-key-id>",               # 您的 Access Key ID
10.     "<your-access-key-secret>"            # 您的 Access Key Secret
11. );
13. $client = new DefaultAcsClient($clientProfile);
15. # 创建 API 请求并设置参数
16. $request = new DescribeInstancesRequest();
17. $request->setPageSize(10);
20. # 发起请求并处理返回
21. try {
22.     $response = $client->getAcsResponse($request);
23.     print_r($response);
24. } catch(ServerException $e) {
25.     print "Error: " . $e->getErrorCode() . " Message: " . $e->getMessage() . "\n";
26. } catch(ClientException $e) {
27.     print "Error: " . $e->getErrorCode() . " Message: " . $e->getMessage() . "\n";
28. }
30. ?>

在创建 DefaultAcsClient 实例并初始化时，您需要填写 3 个参数：Region ID、Access Key ID和Access Key Secret。Access Key ID和Access Key Secret可以从控制台获得；而Region ID可以从 地域列表中获得。

API参考


要知道您想访问的产品提供的 API 以及它们的参数，请参考 开放了 API 的产品列表。