欢迎使用阿里云开发者工具套件。Alibaba Cloud SDK for PHP是支持PHP开发者快速访问阿里云服务的开发包,由Alibaba Cloud Client for PHP提供底层支持。Alibaba Cloud SDK for PHP让您不用复杂编程即可访问云服务器、云数据库RDS和云监控等多个阿里云服务。

环境准备

  • 您需要一个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文件。

    您可以通过此链接下载 .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自动加载工具。
    <?php
    
    require __DIR__ . '/vendor/autoload.php'; 

使用Alibaba Cloud SDK for PHP

以下代码示例展示了使用Alibaba Cloud SDK for PHP的基本步骤:

  1. 初始化客户端。
    <?php
    
    use AlibabaCloud\Client\AlibabaCloud;
    
    AlibabaCloud::accessKeyClient('accessKeyId', 'accessKeySecret')->asDefaultClient();
  2. 发起调用。
    • 使用RPC调用:
      <?php
      
      use AlibabaCloud\Client\AlibabaCloud;
      use AlibabaCloud\Client\Exception\ClientException;
      use AlibabaCloud\Client\Exception\ServerException;
      
      try {
          $result = AlibabaCloud::rpc()
                                ->product('Cdn')
                                ->version('2014-11-11')
                                ->action('DescribeCdnService')
                                ->method('POST')
                                ->request();
      
          print_r($result->toArray());
      
      } catch (ClientException $exception) {
          print_r($exception->getErrorMessage());
      } catch (ServerException $exception) {
          print_r($exception->getErrorMessage());
      }
    • 使用ROA调用:
      <?php
      
      use AlibabaCloud\Client\AlibabaCloud;
      use AlibabaCloud\Client\Exception\ClientException;
      use AlibabaCloud\Client\Exception\ServerException;
      
      try {
          $result = AlibabaCloud::roa()
                                ->regionId('cn-hangzhou') // 指定请求的地域,不指定则使用客户端地域、默认地域。
                                ->product('CS') // 指定产品。
                                ->version('2015-12-15') // 指定产品版本。
                                ->action('DescribeClusterServices') // 指定产品接口。
                                ->serviceCode('cs') // 设置ServiceCode以备寻址,非必须。
                                ->endpointType('openAPI') // 设置类型,非必须。
                                ->method('GET') // 指定请求方式。
                                ->host('cs.aliyun.com') // 指定域名则不会寻址,如认证方式为Bearer Token的服务则需要指定。
                                ->pathPattern('/clusters/[ClusterId]/services') // 指定ROA风格路径规则。
                                ->withClusterId('123456') // 为路径中参数赋值,方法名:with + 参数。
                                ->request(); // 发起请求并返回结果对象,请求需要放在设置的最后面。
      
          print_r($result->toArray());
      
      } catch (ClientException $exception) {
          print_r($exception->getErrorMessage());
      } catch (ServerException $exception) {
          print_r($exception->getErrorMessage());
      }