Alibaba Cloud SDK:Integración con el SDK V2.0 de Alibaba Cloud para PHP

1. Inicie sesión en Centro de SDK y seleccione el servicio cuyo SDK desea usar. En este ejemplo, se selecciona Short Message Service (SMS).

2. En la página Install, seleccione V2.0 en la lista desplegable SDK Generation y haga clic en PHP dentro de la sección All languages. En la pestaña Quick Start, obtenga el método de instalación del SDK de 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. Gestione los errores

El SDK V2.0 de Alibaba Cloud para PHP clasifica las excepciones en los siguientes tipos:

• TeaUnretryableException: en la mayoría de los casos, este tipo de excepción se debe a problemas de red y se reporta cuando se alcanza el número máximo de reintentos.

• InvalidArgumentException: generalmente, este error se activa cuando no se especifica un parámetro obligatorio o el tipo de parámetro no es válido. Revise el message de error para localizar el problema.

• TeaException: casi siempre, este tipo de excepción se origina por errores de negocio.

Para más información sobre cómo gestionar las excepciones del SDK, consulte Exception handling.

Escenario especial: Carga de archivos mediante la operación Advance

Cuando use Image Search o Visual Intelligence API (VIAPI) para procesar imágenes en una máquina local o cargar imágenes, la API de Image Search o VIAPI descrita en la documentación no admite la carga directa. Para cargar imágenes, necesita usar la operación Advance, que admite la transmisión de flujos de archivos. El servicio en la nube almacena temporalmente el archivo cargado en Object Storage Service (OSS) y lee el archivo temporal desde OSS cuando es necesario. La región predeterminada de OSS es cn-shanghai. El siguiente ejemplo muestra cómo llamar a la operación DetectBodyCount de VIAPI:

1. Inicialice un cliente de solicitud

   Asegúrese de especificar tanto el parámetro regionId como el endpoint del servicio en la nube. El parámetro regionId indica la región de OSS donde se almacenan los archivos temporales. Si no configura el parámetro regionId, el servicio en la nube podría usar una región distinta a la de OSS, lo que provocaría tiempos de espera agotados en la 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. Cree un objeto de solicitud

   Cree el objeto de solicitud <API operation>AdvanceRequest para pasar flujos de archivos. En el objeto de solicitud, establezca el nombre del parámetro como 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. Envíe una solicitud

   Llame a la operación <API operation>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();

Preguntas frecuentes

• ¿Cómo gestiono el error "You are not authorized to perform this operation" que devuelve una operación de API?

  Posibles causas: el par de AccessKey del usuario de Resource Access Management (RAM) no tiene los permisos necesarios para llamar a la operación de API.

  Soluciones: otorgue los permisos necesarios al usuario de RAM. Para más información, consulte Manage RAM user permissions.

  Por ejemplo, si la operación de API SendMessageToGlobe devuelve el error "You are not authorized to perform this operation", cree la siguiente política personalizada para otorgar los permisos necesarios al usuario de RAM:

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

• ¿Cómo gestiono el error de endpoint "PHP Fatal error: Uncaught exception 'GuzzleHttp\Exception\RequestException'" cuyo mensaje de error es cURL error 3?

  Posibles causas: la operación de API no es compatible con el endpoint que especificó al inicializar el cliente de solicitud.

  Soluciones: especifique un endpoint compatible e inténtelo de nuevo. Para más información, consulte Configure an endpoint.

• ¿Cómo gestiono el error de AccessKey "PHP Fatal error: Uncaught ArgumentCountError: Too few arguments to function AlibabaCloud\Credentials\AccessKeyCredential::__construct(), 1 passed and exactly 2" que devuelve una operación de API?

  Posibles causas: el par de AccessKey no se pasó correctamente a la solicitud.

  Soluciones: asegúrese de pasar correctamente el par de AccessKey al inicializar el cliente de solicitud. El valor XXX de getenv("XXX") se obtiene de la variable de entorno.

• ¿Cómo gestiono el error "code: 414 URL Too Long" que devuelve el SDK de Alibaba Cloud?

  Posibles causas: este problema no se debe al método de solicitud. Cuando usa el SDK de Alibaba Cloud, los parámetros de solicitud se pasan en las URL. Si una URL contiene demasiados parámetros o valores de parámetros muy largos, puede superar la longitud máxima permitida y provocar errores en la solicitud.

  Soluciones: para evitar URL demasiado largas, se recomienda usar request syntax and signature method V3. Utilice firmas autofirmadas para pasar los parámetros en el cuerpo de la solicitud y establezca el tipo de cuerpo como Content-Type: application/x-www-form-urlencoded.

Para más información sobre cómo gestionar los errores del SDK, consulte FAQ.