Alibaba Cloud SDK:Intégration avec le SDK Alibaba Cloud V2.0 pour PHP

1. Connectez-vous au SDK Center et sélectionnez le service dont vous souhaitez utiliser le SDK. Dans cet exemple, le service Short Message Service (SMS) est sélectionné.

2. Sur la page Install, sélectionnez V2.0 dans la liste déroulante SDK Generation et cliquez sur PHP dans la section All languages. Sous l'onglet Quick Start , obtenez la méthode d'installation du SDK Short Message Service (SMS).

   

public static function createClient(){
      $config = new Config([
            // Required, please ensure that the environment variables ALIBABA_CLOUD_ACCESS_KEY_ID is set.
            "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
            // Required, please ensure that the environment variables ALIBABA_CLOUD_ACCESS_KEY_SECRET is set.
            "accessKeySecret" => getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
        ]);
        $config->endpoint = "dysmsapi.aliyuncs.com";
        return new Dysmsapi($config);
    }

// Create request object and set required input parameters
$sendMessageToGlobeRequest = new SendMessageToGlobeRequest([
            // Please replace with the actual recipient number.
            "to" => "<YOUR_VALUE>",
            // Please replace with the actual SMS content.
            "message" => "<YOUR_VALUE>"
        ]);

 // Create runtime parameters.
 $runtime = new RuntimeOptions([]);
 $client = self::createClient();
 // Send a request.
 $client->sendMessageToGlobeWithOptions($sendMessageToGlobeRequest, $runtime);

4. Gérer les erreurs

Le SDK Alibaba Cloud V2.0 pour PHP classe les exceptions dans les types suivants :

• TeaUnretryableException : Dans la plupart des cas, ce type d'exception est causé par des problèmes réseau et est signalé lorsque le nombre maximal de tentatives est atteint.

• InvalidArgumentException : Dans la plupart des cas, ce type d'erreur est déclenché lorsqu'un paramètre requis n'est pas spécifié ou que le type de paramètre est invalide. Vous pouvez vérifier le message d'erreur pour localiser l'erreur.

• TeaException : Dans la plupart des cas, ce type d'exception est causé par des erreurs métier.

Pour plus d'informations sur la gestion des exceptions SDK, consultez Gestion des exceptions.

Scénario spécial : Téléchargement de fichiers via l'opération Advance

Lorsque vous utilisez Image Search ou Visual Intelligence API (VIAPI) pour traiter des images sur une machine locale ou télécharger des images, l'API d'Image Search ou de VIAPI décrite dans la documentation ne prend pas en charge le téléchargement direct. Pour télécharger des images, vous devez utiliser l'opération Advance, qui prend en charge la transmission de flux de fichiers. Le service cloud stocke temporairement le fichier téléchargé dans Object Storage Service (OSS), et lit le fichier temporaire depuis OSS si nécessaire. La région par défaut d'OSS est cn-shanghai. L'exemple suivant montre comment appeler l'opération DetectBodyCount de VIAPI :

1. Initialiser un client de requête

   Assurez-vous que le paramètre regionId et l'endpoint du service cloud sont spécifiés. regionId indique la région OSS dans laquelle les fichiers temporaires sont stockés. Si vous ne configurez pas le paramètre regionId, le service cloud peut utiliser une région différente de celle d'OSS, ce qui entraîne des délais d'expiration de l'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. Créer un objet de requête

   Créez l'objet de requête <opération API>AdvanceRequest pour transmettre des flux de fichiers. Dans l'objet de requête, définissez le nom du paramètre sur 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. Initier une requête

   Appelez l'opération <opération 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();

FAQ

• Comment gérer l'erreur « You are not authorized to perform this operation » générée par une opération API ?

  Causes possibles : La paire AccessKey de l'utilisateur Resource Access Management (RAM) ne dispose pas des autorisations nécessaires pour appeler l'opération API.

  Solutions : Accordez les autorisations requises à l'utilisateur RAM. Pour plus d'informations, consultez Gérer les autorisations des utilisateurs RAM.

  Par exemple, si l'erreur « You are not authorized to perform this operation » est générée par l'opération API SendMessageToGlobe, créez la stratégie personnalisée suivante pour accorder les autorisations requises à l'utilisateur RAM :

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

• Comment gérer l'erreur d'endpoint « PHP Fatal error: Uncaught exception 'GuzzleHttp\Exception\RequestException » dont le message d'erreur est cURL error 3 ?

  Causes possibles : L'opération API ne prend pas en charge l'endpoint que vous spécifiez lors de l'initialisation du client de requête.

  Solutions : Spécifiez un endpoint pris en charge et réessayez. Pour plus d'informations, consultez Configurer un endpoint.

• Comment gérer l'erreur AccessKey « PHP Fatal error: Uncaught ArgumentCountError: Too few arguments to function AlibabaCloud\Credentials\AccessKeyCredential::__construct(), 1 passed and exactly 2 » générée par une opération API ?

  Causes possibles : La paire AccessKey n'est pas correctement transmise à la requête.

  Solutions : Assurez-vous que la paire AccessKey est correctement transmise lors de l'initialisation du client de requête. La valeur XXX de getenv("XXX") est obtenue à partir de la variable d'environnement.

• Comment gérer l'erreur « code: 414 URL Too Long » générée par le SDK Alibaba Cloud ?

  Causes possibles : Ce problème n'est pas causé par la méthode de requête. Lorsque vous utilisez le SDK Alibaba Cloud, les paramètres de requête sont transmis dans les URL. Si une URL contient un nombre excessif de paramètres ou des valeurs de paramètre trop longues, l'URL peut dépasser la longueur maximale et provoquer des échecs de requête.

  Solutions : Pour éviter les URL trop longues, nous vous recommandons d'utiliser la syntaxe de requête et la méthode de signature V3. Utilisez des signatures autosignées pour transmettre les paramètres dans le corps de la requête et définissez le type de corps sur Content-Type: application/x-www-form-urlencoded.

Pour plus d'informations sur la gestion des erreurs SDK, consultez FAQ.