Alibaba Cloud SDK:Intégrer Alibaba Cloud SDK V2.0 pour PHP

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

2. Sur la page Install, sélectionnez V2.0 dans la liste déroulante SDK Generation, puis cliquez sur PHP dans la section All languages. Sous l'onglet Quick Start, récupérez 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

Alibaba Cloud SDK V2.0 pour PHP classe les exceptions dans les catégories suivantes :

• TeaUnretryableException : Ce type d'exception résulte généralement de problèmes réseau et survient lorsque le nombre maximal de tentatives est atteint.

• InvalidArgumentException : Cette erreur se déclenche habituellement lorsqu'un paramètre obligatoire n'est pas spécifié ou lorsque le type de paramètre est invalide. Consultez le message d'erreur pour localiser le problème.

• TeaException : Ce type d'exception provient généralement d'erreurs métier.

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

Scénario particulier : Téléversement 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éverser des images, l'API d'Image Search ou de VIAPI décrite dans la documentation ne prend pas en charge le téléversement direct. Pour téléverser des images, utilisez l'opération Advance, qui permet la transmission de flux de fichiers. Le service cloud stocke temporairement le fichier téléversé 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 tous deux spécifiés. Le paramètre regionId indique la région OSS où les fichiers temporaires sont stockés. Si vous ne configurez pas le paramètre regionId, le service cloud risque d'utiliser une région différente de celle d'OSS, ce qui entraînera des délais d'attente d'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 d'API>AdvanceRequest pour transmettre des flux de fichiers. Dans cet objet, 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. Envoyer une requête

   Appelez l'opération <Opération d'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 résoudre l'erreur « You are not authorized to perform this operation » renvoyée par une opération d'API ?

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

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

  Par exemple, si l'erreur « You are not authorized to perform this operation » est renvoyée par l'opération d'API SendMessageToGlobe, créez la politique personnalisée suivante pour accorder les permissions nécessaires à l'utilisateur RAM :

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

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

  Causes possibles : L'opération d'API ne prend pas en charge l'endpoint spécifié 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 résoudre l'erreur AccessKey « PHP Fatal error: Uncaught ArgumentCountError: Too few arguments to function AlibabaCloud\Credentials\AccessKeyCredential::__construct(), 1 passed and exactly 2 » renvoyée par une opération d'API ?

  Causes possibles : La paire AccessKey n'a pas été 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 » renvoyée par Alibaba Cloud SDK ?

  Causes possibles : Ce problème n'est pas lié à la méthode de requête. Avec Alibaba Cloud SDK, les paramètres de requête sont transmis via les URL. Si une URL contient un nombre excessif de paramètres ou des valeurs de paramètres trop longues, elle peut dépasser la longueur maximale autorisée et provoquer l'échec de la 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 auto-signé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 du SDK, consultez FAQ.