Intelligent Media Management:PHP 用 IMM SDK

PHP 用 IMM SDK の使用方法の詳細については、クイックスタートを参照してください。

Composer のインストール

1. composer-setup.php セットアップファイルを現在のディレクトリにダウンロードします。

   php -r "copy('https://install.phpcomposer.com/installer', 'composer-setup.php');"

2. ファイルを開いてインストールを開始します。

   php composer-setup.php

3. セットアップファイルを削除します。

   php -r "unlink('composer-setup.php');"

4. sudo mv composer.phar /usr/local/bin/composer コマンドを実行して、Composer をグローバルにインストールします。インストールが完了すると、composer.phar ファイルが作成されます。php composer.phar ファイルを開いて Composer を使用します。

   

次のサンプルコードは、一時的なアクセス認証情報を使用して、中国 (北京) リージョンのプロジェクト内の画像で顔と顔の属性を検出する方法の例を示しています。

1. demo.php ファイルを作成し、次の内容をファイルに書き込みます。

   <?php
   
   // このファイルは自動生成されています。編集しないでください。ありがとうございます。
   namespace AlibabaCloud\SDK\Sample;
   
   use AlibabaCloud\SDK\Sts\V20150401\Sts;
   use AlibabaCloud\Tea\Utils\Utils;
   use \Exception;
   use AlibabaCloud\Tea\Exception\TeaError;
   
   use Darabonba\OpenApi\Models\Config;
   use AlibabaCloud\SDK\Sts\V20150401\Models\AssumeRoleRequest;
   use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
   
   use AlibabaCloud\SDK\Imm\V20200930\Imm;
   use AlibabaCloud\SDK\Imm\V20200930\Models\DetectImageFacesRequest;
   
   
   class Sample {
          /**
        * AccessKey ID と AccessKey シークレットを使用してクライアントを初期化します。
        * @return imm Client
        */
       public static function createClient(){
           // プロジェクトコードが漏洩した場合、AccessKeyペアが漏洩し、アカウント内のすべてのリソースのセキュリティが侵害される可能性があります。以下の行は参照用にのみ提供されています。
           // セキュリティ上の理由から、Security Token Service (STS) によって提供される一時的なアクセス認証情報を使用することをお勧めします。詳細については、https://www.alibabacloud.com/help/ja/sdk/developer-reference/v2-manage-php-access-credentials を参照してください。
           $stsConfig = 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')
           ]);
           // エンドポイントを指定します。詳細については、https://api.aliyun.com/product/Sts を参照してください。
           $stsConfig->endpoint = "sts.cn-hangzhou.aliyuncs.com";
           $stsClient = new Sts($stsConfig);
           $assumeRoleRequest = new AssumeRoleRequest([
               // 引き受ける RAM ロールの ARN を指定します。例: acs:ram::123456789012****:role/adminrole
               "roleArn" => "acs:ram::125499367423****:role/STStokenTestRole",
               // ロールセッションの名前を指定します。
               "roleSessionName" => "ststest",
               // アクセス認証情報の有効期間を指定します。単位: 秒。
               "durationSeconds" => 3600
           ]);
           $runtime = new RuntimeOptions([]);
           $resp = $stsClient->assumeRoleWithOptions($assumeRoleRequest, $runtime);
           $config = new Config([
               "accessKeyId" => $resp->body->credentials->accessKeyId,
               "accessKeySecret" => $resp->body->credentials->accessKeySecret,
               "securityToken" => $resp->body->credentials->securityToken
           ]);
           // サポートされているリージョンの IMM エンドポイントの一覧については、https://api.alibabacloud.com/product/imm を参照してください。
           $config->endpoint = "imm.cn-hangzhou.aliyuncs.com";
           return new Imm($config);
       }
   
       /**
        * @param string[] $args
        * @return void
        */
       public static function main($args){
           $client = self::createClient();
           $detectImageFacesRequest = new DetectImageFacesRequest([
               "projectName" => "imm-php-sdk-doc-demo",
               "sourceURI" => "oss://your-bucket-name/your-path/your-image.jpg"
           ]);
           $runtime = new RuntimeOptions([]);
           try {
               // 必要に応じて、API オペレーションのレスポンスを出力するコードを記述します。
              print_r($client->detectImageFacesWithOptions($detectImageFacesRequest, $runtime));
           }
           catch (Exception $error) {
               if (!($error instanceof TeaError)) {
                   $error = new TeaError([], $error->getMessage(), $error->getCode(), $error);
               }
               // この例では、エラーが出力されます。実際のプロジェクトでは、ビジネス要件に基づいてエラーを処理してください。
               // エラーメッセージを表示します。
               var_dump($error->message);
               // トラブルシューティング用の URL を表示します。
               var_dump($error->data["Recommend"]);
               Utils::assertAsString($error->message);
           }
       }
   }
   $path = __DIR__ . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
   if (file_exists($path)) {
       require_once $path;
   }
   Sample::main(array_slice($argv, 1));

2. php demo.php コマンドを実行します。出力は次の内容のようになります。

次のサンプルコードは、長期アクセス認証情報を使用して、中国 (北京) リージョンのプロジェクト内の画像で顔と顔の属性を検出する方法の例を示しています。

1. demo.php ファイルを作成し、次の内容をファイルに書き込みます。

   <?php
   
   // このファイルは自動生成されています。編集しないでください。ありがとうございます。
   namespace AlibabaCloud\SDK\Sample;
   
   use AlibabaCloud\SDK\Imm\V20200930\Imm;
   use \Exception;
   use AlibabaCloud\Tea\Exception\TeaError;
   use AlibabaCloud\Tea\Utils\Utils;
   
   use Darabonba\OpenApi\Models\Config;
   use AlibabaCloud\SDK\Imm\V20200930\Models\DetectImageFacesRequest;
   use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;
   
   class Sample {
   
       /**
        * AccessKey ID と AccessKey シークレットを使用してクライアントを初期化します。
        * @return Imm Client
        */
       public static function createClient(){
           // プロジェクトコードが漏洩した場合、AccessKeyペアが漏洩し、アカウント内のすべてのリソースのセキュリティが侵害される可能性があります。以下の行は参照用にのみ提供されています。
           // セキュリティ上の理由から、STS によって提供される一時的なアクセス認証情報を使用することをお勧めします。詳細については、https://www.alibabacloud.com/help/ja/sdk/developer-reference/v2-manage-php-access-credentials を参照してください。
           $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")
           ]);
           // サポートされているリージョンの IMM エンドポイントの一覧については、https://api.alibabacloud.com/product/imm を参照してください。
           $config->endpoint = "imm.cn-beijing.aliyuncs.com";
           return new Imm($config);
       }
   
       /**
        * @param string[] $args
        * @return void
        */
       public static function main($args){
           $client = self::createClient();
           $detectImageFacesRequest = new DetectImageFacesRequest([
               "projectName" => "imm-php-sdk-doc-demo",
               "sourceURI" => "oss://your-bucket-name/your-path/your-image.jpg"
           ]);
           $runtime = new RuntimeOptions([]);
           try {
               // 必要に応じて、API オペレーションのレスポンスを出力するコードを記述します。
              print_r($client->detectImageFacesWithOptions($detectImageFacesRequest, $runtime));
           }
           catch (Exception $error) {
               if (!($error instanceof TeaError)) {
                   $error = new TeaError([], $error->getMessage(), $error->getCode(), $error);
               }
               // この例では、エラーが出力されます。実際のプロジェクトでは、ビジネス要件に基づいてエラーを処理してください。
               // エラーメッセージを表示します。
               var_dump($error->message);
               // トラブルシューティング用の URL を表示します。
               var_dump($error->data["Recommend"]);
               Utils::assertAsString($error->message);
           }
       }
   }
   $path = __DIR__ . \DIRECTORY_SEPARATOR . 'vendor' . \DIRECTORY_SEPARATOR . 'autoload.php';
   if (file_exists($path)) {
       require_once $path;
   }
   Sample::main(array_slice($argv, 1));

2. php demo.php コマンドを実行します。出力は次の内容のようになります。