泛化调用

特点

1. 轻量级：仅需安装Core包即可调用所有OpenAPI，无需依赖各产品的独立SDK。

2. 快速迭代兼容性：当云产品尚未提供相应的SDK，或当新API发布但SDK未能及时更新时，可以使用泛化调用。这样，无需等待SDK的更新，即可及时调用最新发布的API接口。

更多介绍，请参见泛化调用与特化调用。

使用说明

在使用泛化调用之前，必须手动获取并配置OpenAPI的版本号、请求路径、参数类型等元数据信息。可以通过查看OpenAPI元数据来获取有关OpenAPI的API风格、请求参数、资源路径等相关信息。

安装核心SDK

在Terminal中执行以下命令安装核心SDK。

composer require alibabacloud/client

调用OpenAPI

初始化请求客户端

通过在AlibabaCloud包中创建client以初始化请求客户端，并通过该Client发起OpenAPI调用。此处仅列举使用AccessKey（简称：AK）初始化客户端的方式，更多初始化方式请参见管理访问凭据。

use AlibabaCloud\Client\AlibabaCloud;   

   // getenv代表从环境变量获取AK，初始化客户端
    AlibabaCloud::accessKeyClient(
         getenv('ALIBABA_CLOUD_ACCESS_KEY_ID'),
         getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET')
    )
    ->regionId('cn-hangzhou') // 指定区域
    ->asDefaultClient(); // 设为默认客户端  
  

配置OpenAPI信息及请求参数

通过AlibabaCloud包中的client来配置OpenAPI所需的公共请求参数及接口请求参数。关于更多公共请求参数的介绍及使用请参见进阶配置。

        // query 查询参数，参数类型为集合时
        $instanceIDs = ["i-bp1axhql4dqXXXXXXXX", "i-bp124uve8zqXXXXXXXX"];
        // 普通参数
        $queryParams = [
            'RegionId' => 'cn-hangzhou',
            'PageNumber' => 1,
            'PageSize' => 30,
        ]; 
        // 处理集合参数（转换为InstanceId.1, InstanceId.2格式）
        foreach ($instanceIDs as $index => $id) {
            $queryKey = 'InstanceId.' . ($index + 1);
            $queryParams[$queryKey] = $id;
        }
 // 配置OpenAPI基本信息和请求参数
 $result = AlibabaCloud::rpc() // 接口风格：支持RPC、ROA。
                // 1.配置OpenAPI基本信息
                ->host('ecs.cn-hangzhou.aliyuncs.com') 
                ->product('Ecs') // 产品名称
                ->version('2014-05-26') // 注意版本号需要与API文档一致
                ->action('DescribeInstanceStatus') // API名称，当调用RPC风格API时，必须配置action()指定接口名称
                ->method('POST') // 请求方法：GET、POST
                ->setProtocolType('HTTPS') // 请求协议：HTTPS或HTTP，建议使用HTTPS。
                // ->pathPattern()  // 资源路径，ROA接口必传。RPC接口禁止设置该参数。
                // 2.配置请求参数
                ->options([
                    // 场景一：query参数通query设置
                    'query' => $queryParams
                    
                    // 场景二：body参数通过form_params设置
                    // 'form_params' => [ 
                    //     'key1' => 'value1',
                    //     'key2' => 'value2',
                    //     'key3' => 'value3',
                    // ],
                ])
  

发起请求

通过client调用request()发起请求。

 // 调用RPC风格API
 $result = AlibabaCloud::rpc()
           ->request()
 // 调用ROA风格API 
 // $result = AlibabaCloud::roa() 
 //         ->request()        
 // 返回值是 bytes 类型，包含RequestId以及OpenAPI的返回参数          
 print_r($result->toArray());       

代码示例

示例：调用RPC风格的API

以调用ECS的DescribeRegions接口为例，展示如何使用泛化调用方式。

<?php

namespace AlibabaCloud\SDK\Sample;
require_once 'vendor/autoload.php';
use AlibabaCloud\Tea\Utils\Utils;
use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;

class Sample
{   
    public static function main()
    {

    // getenv代表从环境变量获取AK，初始化客户端
    AlibabaCloud::accessKeyClient(
         getenv('ALIBABA_CLOUD_ACCESS_KEY_ID'),
         getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET')
    )
    ->regionId('cn-hangzhou') // 指定区域
    ->asDefaultClient(); // 设为默认客户端

        // query 查询参数，参数类型为集合时
        $instanceIDs = ["i-bp1axhql4dqXXXXXXXX", "i-bp124uve8zqXXXXXXXX"];
        // 普通参数
        $queryParams = [
            'RegionId' => 'cn-hangzhou',
            'PageNumber' => 1,
            'PageSize' => 30,
        ]; 
        // 处理集合参数（转换为InstanceId.1, InstanceId.2）
        foreach ($instanceIDs as $index => $id) {
            $queryKey = 'InstanceId.' . ($index + 1);
            $queryParams[$queryKey] = $id;
        }
        try {
            $result = AlibabaCloud::rpc()
                ->method('POST') // 请求方法
                ->verify(false) // 关闭证书校验
                ->debug(true)  // 开启日志
                ->setProtocolType('HTTPS') // 设置协议类型
                ->host('ecs.cn-hangzhou.aliyuncs.com') // 服务地址
                ->version('2014-05-26') // 注意版本号需要与API文档一致
                ->action('DescribeInstanceStatus') // 接口名称
                // 配置请求参数
                ->options([
                    'query' => $queryParams
                ])
                // 发起请求
                ->request();
            print_r($result->toArray());
        } catch (ClientException | ServerException $e) {
            echo $e->getErrorMessage();
        } catch (ServerException $exception) {
            print_r($exception->getErrorMessage());
        }
}
}

Sample::main();

以下代码展示了如何使用泛化调用的方式调用容器服务的 DescribeClustersV1 接口：

<?php
namespace AlibabaCloud\SDK\Sample;
require_once 'vendor/autoload.php';
use AlibabaCloud\Client\AlibabaCloud;
use AlibabaCloud\Client\Exception\ClientException;
use AlibabaCloud\Client\Exception\ServerException;

class Sample
{
  public static function main()
    {
    try {
        $result = AlibabaCloud::roa()
                          ->regionId('cn-hangzhou') // 指定请求的地域，不指定则使用客户端地域、默认地域。
                          ->product('CS') // 指定产品。
                          ->version('2015-12-15') // 指定产品版本。
                          ->serviceCode('cs') // 设置 ServiceCode 以备寻址，非必须。
                          ->endpointType('openAPI') // 设置类型，非必须。
                          ->method('GET') // 指定请求方式。
                          ->host('cs.aliyuncs.com') // 指定域名则不会寻址，如认证方式为 Bearer Token 的服务则需要指定。
                          ->pathPattern('/api/v1/clusters') // API资源路径，当调用ROA风格API时，必须配置pathPattern()指定完整资源路径。从OpenAPI元数据中data.path获取资源路径。
                          ->request(); // 发起请求并返回结果对象，请求需要放在设置的最后面。
    print_r($result->toArray());
    } catch (ClientException $exception) {
    print_r($exception->getErrorMessage());
    } catch (ServerException $exception) {
    print_r($exception->getErrorMessage());
}
    }
}
Sample::main();