Alibaba Cloud SDK：整合SDK

1. 登入SDK Center，選擇將要使用產品，例如您將要調用Short Message Service (SMS)的API。

2. 在安裝頁面，SDK 代系選擇V2.0，所有語言選擇PHP。然後在快速入門頁簽中，您可以擷取Short Message Service (SMS)的SDK安裝方式。

   

4. 異常處理

V2.0 PHP SDK將異常進行了細緻的分類，主要劃分為InvalidArgumentException、TeaUnretryableException和TeaException。

• TeaUnretryableException：主要是因為網路問題造成，一般是網路問題達到最大重試次數後拋出。

• InvalidArgumentException：主要是由於未填寫必填參數或填寫的參數類型不符所導致，可以通過查看異常資訊中的message來定位錯誤。

• TeaException：主要以業務報錯為主的異常。

更多關於異常處理的介紹，請參見異常處理。

特殊情境：檔案上傳 Advance 介面配置

在使用Image Search、視覺智能開放平台等雲產品處理本地圖片或上傳圖片時，官方文檔中提供的OpenAPI介面不支援直接上傳檔案。若需上傳檔案，可以使用雲產品提供的Advance介面，該介面支援傳遞檔案流對象。其底層實現機製為：雲產品會將上傳的檔案臨時儲存於阿里雲OSS上，預設儲存地區為cn-shanghai，並通過讀取該OSS中的臨時檔案來實現相關功能。以阿里雲提供的視覺智能開放平台-人臉人體的DetectBodyCount介面為例：

1. 初始化請求用戶端

   請注意需同時設定regionId和雲產品的endpoint。其中，regionId表示臨時檔案在OSS中所儲存的地區。如果未設定regionId，可能會由於雲產品與OSS所在地區不同，導致在調用OpenAPI時出現逾時等問題。

   function createClient()
   {
       $config = new Config([
           // getenv表示從環境變數擷取憑據
           // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID。
           "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
           // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
           "accessKeySecret" => getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
       ]);
       // endpoint 和 regionId 需設定為同一地區
       $config->endpoint = "facebody.cn-shanghai.aliyuncs.com";
       $config->regionId = "cn-shanghai";
       return new Facebody($config);
   }

2. 建立請求對象

   通過建立<OpenAPI名稱>AdvanceRequest請求對象傳遞檔案流。參數名固定為ImageURLObject。

           // 讀取檔案並轉為 Stream 對象
           $imagePath = "<FILE_PATH>";   // 需替換檔案路徑
           try {
               $fileStream = new Stream(fopen($imagePath, "r"));
           } catch (\Exception $e) {
               die("檔案讀取失敗: " . $e->getMessage());
           }
           // 建立請求對象設定參數
           $detectBodyCountAdvanceRequest = new DetectBodyCountAdvanceRequest([
               "imageURLObject" =>  $fileStream
           ]);   

3. 發起請求

   需調用函數<介面名稱>Advance發起請求。

    // 運行時配置
    $runtime = new RuntimeOptions([]);
    $client = self::createClient();
    // 發起請求      
    $client->detectBodyCountAdvance($detectBodyCountAdvanceRequest, $runtime);

<?php

// composer require alibabacloud/facebody-20191230

namespace AlibabaCloud\SDK\Sample;
use Darabonba\OpenApi\Models\Config;
use GuzzleHttp\Psr7\Stream;
use AlibabaCloud\SDK\Facebody\V20191230\Facebody;
use \Exception;
use AlibabaCloud\Tea\Exception\TeaError;
use AlibabaCloud\SDK\Facebody\V20191230\Models\DetectBodyCountAdvanceRequest;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;

require_once 'vendor/autoload.php';

class Sample
{
    public static function createClient()
    {
        $config = new Config([
            // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_ID。
            "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
            // 必填，請確保代碼運行環境設定了環境變數 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
            "accessKeySecret" => getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
        ]);
        $config->regionId = "cn-shanghai";
        return new Facebody($config);
    }

    public static function main()
    {
        $client = self::createClient();

        // 讀取檔案並轉為 Stream 對象  
        $imagePath = "<FILE_PATH>";   // 需替換檔案路徑
        if (!file_exists($imagePath)) {
            die("File does not exist: $imagePath");
        }
        try {
            $fileStream = new Stream(fopen($imagePath, "r"));
        } catch (Exception $e) {
            die("檔案讀取失敗： " . $e->getMessage());
        }
        // 建立請求對象
        $detectBodyCountAdvanceRequest = new DetectBodyCountAdvanceRequest([
            "imageURLObject" => $fileStream
        ]);
        // 運行時配置
        $runtime = new RuntimeOptions([]);
        try {
            // 發起請求
            $resp = $client->detectBodyCountAdvance($detectBodyCountAdvanceRequest, $runtime);
            var_dump($resp->body);
        } catch (Exception $error) {
            if (!($error instanceof TeaError)) {
                $error = new TeaError([], $error->getMessage(), $error->getCode(), $error);
            }
            var_dump($error);
        }
    }
}

Sample::main();

常見問題

• 調用OpenAPI時報錯，提示“You are not authorized to perform this operation”。

  問題原因：您所使用的AccessKey對應的RAM使用者沒有許可權調用該API。

  解決方案：請為該RAM使用者授予相應OpenAPI許可權。關於如何為RAM使用者進行授權，請參見為RAM使用者授權。

  例如，當您在調用SendMessageToGlobe時提示“You are not authorized to perform this operation”，您可以建立如下所示的自訂權限原則，並為該RAM使用者授予相應的許可權。

  {
    "Version": "1",
    "Statement": [
      {
        "Effect": "Allow",
        "Action": "dysms:SendMessageToGlobe",
        "Resource": "*"
      }
    ]
  }

• 在調用OpenAPI時發生錯誤，提示為 PHP Fatal error: Uncaught exception 'GuzzleHttp\Exception\RequestException'，錯誤資訊為 'cURL error 3'，該錯誤與 'Endpoint' 相關。

  問題原因：您所調用的OpenAPI不支援在初始化請求用戶端時填寫的Endpoint。

  解決方案：請查看Endpoint 配置，修改Endpoint後重新調用OpenAPI。

• 調用OpenAPI時報錯，提示：“PHP Fatal error: Uncaught ArgumentCountError: Too few arguments to function AlibabaCloud\Credentials\AccessKeyCredential::__construct(), 1 passed and exactly 2” 該錯誤與'AccessKey'相關。

  問題原因：您的AccessKey未正確傳遞。

  解決方案：在初始化請求用戶端時，檢查是否正確傳遞AccessKey。請注意getenv("XXX")表示從環境變數中擷取XXX的值。

• 使用SDK時報錯，code ：414 URL Too Long。

  問題原因：該問題與所設定的請求方式無關。在使用SDK時，請求參數是通過URL進行傳遞的。當參數數量過多或參數值過長時，可能會導致URL長度超出限制，從而引發請求失敗。

  解決方案：為避免因使用SDK時URL過長而引發的問題，建議您改用V3版本請求體&簽名機制，使用自簽名的方式通過請求體body傳參，body類型需設定為Content-Type: application/x-www-form-urlencoded。

更多SDK使用過程中的報錯問題解決方案，請參見常見問題。