Alibaba Cloud SDK：整合SDK

環境要求

• PHP版本 >= 5.6。

• 必須在系統上全域安裝 Composer。

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

第二步：引入SDK

阿里雲SDK支援泛化調用與特化調用兩種方式調用OpenAPI，詳情參見泛化調用與特化調用，不同的調用方式需要引入的SDK也不同。

特化調用

您可以訪問OpenAPI門戶網站，搜尋您需要的產品，查看產品支援的SDK語言及安裝方法，然後在您的專案中引入SDK。本案例的SDK擷取步驟如下：

1. 訪問簡訊服務SDK。

2. 在所有語言欄目中選擇您需要的SDK語言。

3. 選擇您需要的安裝方式，將代碼複製到您的專案中。

4. 在您的專案中載入該依賴包。

其PHP語言安裝產品如下：

composer require alibabacloud/dysmsapi-20170525 2.0.23

泛化調用

泛化調用方式不依賴任何一個產品的SDK，只依賴如下核心包Darabonba\OpenApi。其PHP語言安裝設定檔如下，最新版本請參見alibabacloud/darabonba-openapi。：

composer require alibabacloud/darabonba-openapi

第三步：調用OpenAPI

您可以根據快速開始文檔下載範例程式碼。接下來我們以特化調用代碼為例，講解調用過程。如果您選擇泛化調用方案，請開啟Common模式產生樣本的開關，更多資訊請參見泛化調用與特化調用。

初始化請求用戶端

方法一：使用AK初始化

<?php
use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\SDK\Dysmsapi\V20170525\Dysmsapi as DysmsAPI;

public static function createClient(){
	$config = new Config([
		// 必填，您的 AccessKey ID
		"accessKeyId" => getenv('ALIBABA_CLOUD_ACCESS_KEY_ID'),
		// 必填，您的 AccessKey Secret
		"accessKeySecret" => getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET')
	]);
	// Endpoint 請參考 https://api.aliyun.com/product/Dysmsapi
	$config->endpoint = "dysmsapi.aliyuncs.com";
	// 特化請求用戶端
	$dysmsApiClient = new DysmsAPI($config);
}

方法二：使用STS Token初始化

<?php
use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\SDK\Dysmsapi\V20170525\Dysmsapi as DysmsAPI;

public static function createClient(){
	$config = new Config([
		// 必填，您的 AccessKey ID
		"accessKeyId" => getenv('ALIBABA_CLOUD_ACCESS_KEY_ID'),
		// 必填，您的 AccessKey Secret
		"accessKeySecret" => getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET'),
		// 必填，您的STS Token
		"securityToken" => getenv('ALIBABA_CLOUD_SECURITY_TOKEN')
	]);
	// Endpoint 請參考 https://api.aliyun.com/product/Dysmsapi
	$config->endpoint = "dysmsapi.aliyuncs.com";
	// 特化請求用戶端
	$dysmsApiClient = new DysmsAPI($config);
}

方法三：使用Credentials工具初始化

<?php

use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\Credentials\Credential;
use AlibabaCloud\SDK\Dysmsapi\V20170525\Dysmsapi as DysmsAPI;

// 使用預設憑證初始化Credentials Client。
$credential = new Credential([]);
$config = new Config([
	// 使用 credential 配置憑證
	'credential'        => $credential,
]);
// 若接入dysmsapi即簡訊服務，則初始化dysmsapi產品包的Client類
$config->endpoint = 'dysmsapi.aliyuncs.com';
// 初始化dysmsapi產品包的Client類
$dysmsApiClient = new DysmsAPI($config);

建立請求對象&運行時配置

通常您需要根據業務的實際需要傳入參數，您也可自訂運行時配置。

// 建立請求對象並設定入參
$sendSmsRequest = new SendSmsRequest([
"phoneNumbers" => "<YOUR_VALUE>",
"signName" => "<YOUR_VALUE>"
]);
// 建立運行時設定物件
$runtime = new RuntimeOptions([]);

發起請求

• <介面名稱>：使用預設的運行時配置發起介面調用，可以不用傳入運行參數的要求方法。

  <?php
  
  use AlibabaCloud\SDK\Dysmsapi\V20170525\Dysmsapi;
  use AlibabaCloud\SDK\Dysmsapi\V20170525\Models\SendSmsRequest;
  use Darabonba\OpenApi\Models\Config;
  use AlibabaCloud\Credentials\Credential;
  
  // composer 自動載入機制，require_once(vendor目錄下autoload.php檔案)
  require_once('../vendor/autoload.php');
  
  // 使用預設憑證初始化Credentials Client。
  $credentialClient = new Credential([]);
  $smsConfig = new Config([
      // 使用 credential 配置憑證
      'credential' => $credentialClient,
      // 產品服務網域名稱
      'endpoint' => 'ecs.aliyuncs.com'
  ]);
  $smsClient = new Dysmsapi($smsConfig);
  // 構造請求對象
  $sendSmsRequest = new SendSmsRequest([]);
  // 擷取響應對象
  $response = $smsClient->sendSms($sendSmsRequest);
  var_dump($response);

• <介面名稱>WithOptions：可配置自訂運行時參數發起介面調用，更多運行時參數配置請參見進階配置。

  <?php
  
  use AlibabaCloud\SDK\Dysmsapi\V20170525\Dysmsapi;
  use AlibabaCloud\SDK\Dysmsapi\V20170525\Models\SendSmsRequest;
  use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
  use Darabonba\OpenApi\Models\Config;
  use AlibabaCloud\Credentials\Credential;
  
  // composer 自動載入機制，require_once(vendor目錄下autoload.php檔案)
  require_once('../vendor/autoload.php');
  
  // 使用預設憑證初始化Credentials Client。
  $credentialClient = new Credential([]);
  $smsConfig = new Config([
      // 使用 credential 配置憑證
      'credential' => $credentialClient,
      // 產品服務網域名稱
      'endpoint' => 'ecs.aliyuncs.com'
  ]);
  $smsClient = new Dysmsapi($smsConfig);
  // 構造請求對象
  $sendSmsRequest = new SendSmsRequest([]);
  $runtime = new RuntimeOptions();
  // 是否自動重試
  $runtime->autoretry = true;
  // 連線逾時
  $runtime->connectTimeout = 10000;
  // 讀取逾時
  $runtime->readTimeout    = 10000;
  // 擷取響應對象
  $response = $smsClient->sendSmsWithOptions($sendSmsRequest,$runtime);
  var_dump($response);

• <介面名稱>Advance：專門用於應對直接上傳Object 的情境，該方法預設需要傳入運行時參數。下述樣本以視覺智能開放平台人體人臉產品為例介紹SDK如何使用本地檔案上傳調用 API。

  <?php
  
  use Darabonba\OpenApi\Models\Config;
  use GuzzleHttp\Psr7\Stream;
  use AlibabaCloud\Credentials\Credential;
  use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
  use AlibabaCloud\Tea\Exception\TeaError;
  use AlibabaCloud\SDK\Facebody\V20191230\Facebody;
  use AlibabaCloud\SDK\Facebody\V20191230\Models\DetectBodyCountAdvanceRequest;
  
  // composer 自動載入機制，require_once(vendor目錄下autoload.php檔案)
  require_once('../vendor/autoload.php');
  
  $credentialClient = new Credential([]);
  $facebodyConfig = new Config([
      // 使用 credential 配置憑證
      'credential' => $credentialClient,
      // 產品服務網域名稱
      'endpoint' => 'facebody.cn-shanghai.aliyuncs.com'
  ]);
  
  $request = new DetectBodyCountAdvanceRequest();
  // 讀取檔案並將檔案流配置給SDK請求對象
  $request->imageURLObject = new Stream(fopen("<filepath>", "rb"));
  
  $runtime = new RuntimeOptions();
  $facebodyClient = new Facebody($facebodyConfig);
  
  try {
      // 調用本地檔案上傳方法，將檔案上傳
      $response = $facebodyClient->detectBodyCountAdvance($request, $runtime);
      var_dump($response);
  } catch (TeaError $e) {
      var_dump($e->getMessage());
      var_dump($e->getErrorInfo());
      var_dump($e->getLastException());
      var_dump($e->getLastRequest());
  }