PHP SDK 的安装与调用

本文来自于【阿里云官方镜像站：https://developer.aliyun.com/mirror/?utm_content=g_1000307095 】

原文链接：https://developer.aliyun.com/article/753970?spm=a2c6h.12873581.0.0.54c47e46mLfYep

镜像下载、域名解析、时间同步请点击 阿里巴巴开源镜像站

一、环境准备

您需要一个RAM账号以及一对AccessKey ID和AccessKey Secret。请在阿里云控制台中的AccessKey管理页面上创建和查看您的AccessKey，或联系您的系统管理员。使用Alibaba Cloud SDK for PHP调用某个产品的API前，确保您已经在阿里云控制台开通了该产品。已安装PHP。Alibaba Cloud SDK for PHP适用于PHP 5.5.0或更高版本。 您可以通过php -v命令查看当前使用的PHP版本号。

说明 如果您使用了RsaKeyPair客户端（仅支持日本站），还需要安装OpenSSL PHP扩展。

安装cURL，并使用TLS后端编译cURL 7.16.2+。

二、安装Alibaba Cloud SDK for PHP

您可以通过如下两种方式安装Alibaba Cloud SDK for PHP：

（推荐）通过Composer安装依赖。Composer是一款PHP工具，用于管理和安装项目的依赖项。
下载使用包含所有类和依赖项的ZIP文件。点击 sdk .zip 下载压缩包，并在项目中的选定位置解压，以获取Alibaba Cloud SDK for PHP。

完成以下操作，通过Composer安装Alibaba Cloud SDK for PHP作为依赖项。
1、下载并安装Composer。

Linux/MacOS：curl -sS https://getcomposer.org/installer | php
假设下载composer.phar二进制文件至当前目录$HOME中。Windows：单击这里下载并安装Composer。

2、设置环境变量。

Linux/MacOS：

说明 完成本步骤之前，请确保PATH系统变量值中存在/usr/local/bin路径，否则请您根据实际情况为Composer设置可用的环境变量。

执行以下命令，将composer.phar二进制文件移动到全局环境/usr/local/bin/composer目录下。
点击 试用 可进入调用模式

sudo mv composer.phar /usr/local/bin/composer
成功设置环境变量后，您就可以直接在您的终端使用composer命令了。Windows：安装Composer过程中会自动配置环境变量，请跳过此步骤。

3、执行以下命令，安装Alibaba Cloud SDK for PHP至当前目录下。

composer require alibabacloud/sdk

说明 若由于网络问题无法正常安装，您可以使用阿里云Composer全量镜像。

4、在PHP脚本中引入Composer自动加载工具。

<?phprequire __DIR__ . '/vendor/autoload.php';

三、调用Alibaba Cloud SDK for PHP

以下代码示例展示了调用阿里云产品云服务器ECS的简单操作。详细说明，请参见使用说明。

<?phpuse AlibabaCloud\Client\AlibabaCloud;use AlibabaCloud\Client\Exception\ClientException;use AlibabaCloud\Client\Exception\ServerException;use AlibabaCloud\Ecs\Ecs;// 使用您获取的凭证设置全局客户端// AlibabaCloud::accessKeyClient('accessKeyId', 'accessKeySecret')->asDefaultClient();AlibabaCloud::accessKeyClient('foo', 'bar')
           ->regionId('cn-hangzhou')
           ->asDefaultClient();try {    // 访问产品 APIs
   $request = Ecs::v20140526()->describeRegions();    // 设置选项/参数并执行请求
   $result = $request->withResourceType('type') // API 的参数
                     ->withInstanceChargeType('type') // API 的参数
                     ->client('client1') // 指定发送客户端，否则使用全局客户端
                     ->debug(true) // 开启调试会输出详细信息
                     ->connectTimeout(0.01) // 连接超时会抛出异常
                     ->timeout(0.01) // 超时会抛出异常
                     ->request(); // 执行请求
   // 也可以传入数组设置
   $options = [                   'debug'           => true,                   'connect_timeout' => 0.01,                   'timeout'         => 0.01,                   'query'           => [                       'ResourceType' => 'type',                       'InstanceChargeType' => 'type',
                  ],
              ];    // 设置的优先级
   $result2 = Ecs::v20140526()
                 ->describeRegions($options)
                 ->options([                                'query' => [                                    'Key'      => '我会覆盖构造函数的这个值',                                    'new'      => '我是新增的值',
                               ],
                           ])
                 ->options([                                'query' => [                                    'Key' => '我会覆盖以前的值',                                    'bar' => '我是新增的值',
                               ],
                           ])
                 ->debug(false) // 最后调用的会覆盖前者
                 ->request();
} catch (ClientException $exception) {    echo $exception->getMessage(). PHP_EOL;
} catch (ServerException $exception) {    echo $exception->getMessage() . PHP_EOL;    echo $exception->getErrorCode(). PHP_EOL;    echo $exception->getRequestId(). PHP_EOL;    echo $exception->getErrorMessage(). PHP_EOL;
}