Alibaba Cloud SDK:Alibaba Cloud SDK V2.0 for PHP と統合する

1. SDK Center にログインし、SDK を使用するサービスを選択します。 この例では、Short Message Service (SMS) を選択します。

2. [インストール] ページで、[SDK の生成] ドロップダウンリストから [V2.0] を選択し、[すべての言語] セクションで [PHP] をクリックします。 [クイックスタート] タブで、Short Message Service (SMS) SDK のインストール方法を取得します。

   

4. エラーを処理する

Alibaba Cloud SDK V2.0 for PHP は、例外を次のタイプに分類します。

• TeaUnretryableException: ほとんどの場合、このタイプの例外はネットワークの問題が原因で発生し、最大再試行回数に達したときに報告されます。

• InvalidArgumentException: ほとんどの場合、このタイプのエラーは、必須パラメータが指定されていないか、パラメータタイプが無効な場合に発生します。 エラー message を確認して、エラーを特定できます。

• TeaException: ほとんどの場合、このタイプの例外はビジネスエラーが原因で発生します。

SDK 例外の処理方法の詳細については、「例外処理」をご参照ください。

特別なシナリオ: Advance オペレーションによるファイルアップロード

オンプレミス機器の画像を処理したり、画像をアップロードしたりするために画像検索または Visual Intelligence API (VIAPI) を使用する場合、ドキュメントに記載されている画像検索または VIAPI の API は直接アップロードをサポートしていません。 画像をアップロードするには、ファイルストリームの送信をサポートする Advance オペレーションを使用する必要があります。 クラウドサービスは、アップロードされたファイルを一時的に Object Storage Service (OSS) に保存し、必要なときに OSS から一時ファイルを読み取ります。 OSS のデフォルトリージョンは cn-shanghai です。 次の例は、VIAPI の DetectBodyCount オペレーションを呼び出す方法を示しています。

1. リクエストクライアントを初期化する

   regionId パラメータとクラウドサービスの endpoint の両方が指定されていることを確認します。 regionId は、一時ファイルが保存される OSS リージョンを示します。 regionId パラメータを構成しないと、クラウドサービスが OSS とは異なるリージョンを使用する可能性があり、API タイムアウトが発生する可能性があります。

   function createClient()
   {
       $config = new Config([
           // getenv specifies that the access credential is obtained from environment variables.
           // Required. Make sure that the following environment variable is set in the code runtime environment: ALIBABA_CLOUD_ACCESS_KEY_ID. 
           "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
           // Required. Make sure that the following environment variable is set in the code runtime environment: ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
           "accessKeySecret" => getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
       ]);
       // Specify the same region for the endpoint and regionId parameters.
       $config->endpoint = "facebody.cn-shanghai.aliyuncs.com";
       $config->regionId = "cn-shanghai";
       return new Facebody($config);
   }

2. リクエストオブジェクトを作成する

   ファイルストリームを渡すために、<API オペレーション>AdvanceRequest リクエストオブジェクトを作成します。 リクエストオブジェクトで、パラメータ名を ImageURLObject に設定します。

   // Read the file and convert it to a Stream object.
           $imagePath = "<FILE_PATH>";   // Replace <FILE_PATH> with the actual file path.
           try {
               $fileStream = new Stream(fopen($imagePath, "r"));
           } catch (\Exception $e) {
               die("Failed to read the file: " . $e->getMessage());
           }
           // Create a request object and configure the request parameters.
           $detectBodyCountAdvanceRequest = new DetectBodyCountAdvanceRequest([
               "imageURLObject" =>  $fileStream
           ]);   

3. リクエストを開始する

   <API オペレーション>AdvanceRequest オペレーションを呼び出します。

   // Configure the runtime parameters.
    $runtime = new RuntimeOptions([]);
    $client = self::createClient();
    // Send the request.      
    $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([
            // Required. Make sure that the following environment variable is set in the code runtime environment: ALIBABA_CLOUD_ACCESS_KEY_ID. 
            "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
            // Required. Make sure that the following environment variable is set in the code runtime environment: 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();

        // Read the file and convert it to a Stream object.  
        $imagePath = "<FILE_PATH>";   // Replace the value with the actual file path.
        if (!file_exists($imagePath)) {
            die("File does not exist: $imagePath");
        }
        try {
            $fileStream = new Stream(fopen($imagePath, "r"));
        } catch (Exception $e) {
            die("Failed to read the file: " . $e->getMessage());
        }
        // Create a request object.
        $detectBodyCountAdvanceRequest = new DetectBodyCountAdvanceRequest([
            "imageURLObject" => $fileStream
        ]);
        // Configure runtime settings.
        $runtime = new RuntimeOptions([]);
        try {
            // Send the request.
            $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();

よくある質問

• API オペレーションによってスローされた「このオペレーションを実行する権限がありません」エラーを処理するにはどうすればよいですか?

  考えられる原因: Resource Access Management (RAM) ユーザーの AccessKey ペアに、API オペレーションを呼び出す権限がありません。

  解決策: 必要な権限を RAM ユーザーに付与します。 詳細については、「RAM ユーザーに権限を付与する」をご参照ください。

  たとえば、SendMessageToGlobe API オペレーションによって「このオペレーションを実行する権限がありません」エラーがスローされた場合は、次のカスタムポリシーを作成して、必要な権限を RAM ユーザーに付与します。

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

• エラーメッセージが cURL エラー 3 である「PHP Fatal error: Uncaught exception 'GuzzleHttp\Exception\RequestException" endpoint エラーを処理するにはどうすればよいですか?

  考えられる原因: リクエストクライアントを初期化するときに指定したエンドポイントは、API オペレーションでサポートされていません。

  解決策: サポートされているエンドポイントを指定して、再試行します。 詳細については、「エンドポイントを構成する」をご参照ください。

• API オペレーションによってスローされた「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 値は、環境変数から取得されます。

• Alibaba Cloud SDK によってスローされた「code: 414 URL Too Long」エラーを処理するにはどうすればよいですか?

  考えられる原因: この問題は、リクエストメソッドが原因ではありません。 Alibaba Cloud SDK を使用する場合、リクエストパラメータは URL で渡されます。 URL に過剰な数のパラメータまたは長すぎるパラメータ値が含まれている場合、URL が最大長を超えてリクエストが失敗する可能性があります。

  解決策: URL が長くなりすぎるのを防ぐために、リクエスト構文と署名メソッド V3 を使用することをお勧めします。 自己署名署名を使用してリクエスト本文でパラメータを渡し、本文タイプを Content-Type: application/x-www-form-urlencoded に設定します。

SDK エラーの処理方法の詳細については、「よくある質問」をご参照ください。