Alibaba Cloud SDK:Integrar o Alibaba Cloud SDK V2.0 para PHP

1. Faça login no SDK Center e selecione o serviço cujo SDK deseja utilizar. Neste exemplo, o Short Message Service (SMS) está selecionado.

2. Na página Install, selecione V2.0 na lista suspensa SDK Generation e clique em PHP na seção All languages. Na aba Quick Start, obtenha o método de instalação do SDK do 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. Tratar erros

O Alibaba Cloud SDK V2.0 para PHP classifica as exceções nos seguintes tipos:

• TeaUnretryableException: Geralmente causada por problemas de rede e reportada quando o número máximo de tentativas é atingido.

• InvalidArgumentException: Normalmente ocorre quando um parâmetro obrigatório não é especificado ou o tipo do parâmetro é inválido. Verifique a message de erro para localizar a falha.

• TeaException: Na maioria dos casos, resulta de erros de negócio.

Para mais informações sobre como lidar com exceções do SDK, consulte Tratamento de exceções.

Cenário especial: Upload de arquivo através da operação Advance

Ao usar Image Search ou Visual Intelligence API (VIAPI) para processar imagens em uma máquina local ou fazer upload de imagens, note que a API descrita na documentação não suporta upload direto. Para enviar imagens, utilize a operação Advance, que suporta transmissão de fluxos de arquivos. O serviço em nuvem armazena temporariamente o arquivo enviado no Object Storage Service (OSS) e lê o arquivo temporário do OSS quando necessário. A região padrão do OSS é cn-shanghai. O exemplo a seguir mostra como chamar a operação DetectBodyCount do VIAPI:

1. Inicializar um cliente de requisição

   Certifique-se de especificar tanto o parâmetro regionId quanto o endpoint do serviço em nuvem. O regionId indica a região do OSS onde os arquivos temporários são armazenados. Se você não configurar o parâmetro regionId, o serviço em nuvem poderá usar uma região diferente da do OSS, resultando em timeouts de 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. Criar um objeto de requisição

   Crie o objeto de requisição <Operação de API>AdvanceRequest para passar fluxos de arquivos. No objeto de requisição, defina o nome do 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. Iniciar uma requisição

   Chame a operação <Operação de 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();

Perguntas frequentes

• Como tratar o erro "You are not authorized to perform this operation" retornado por uma operação de API?

  Causas possíveis: O par de AccessKey do usuário do Resource Access Management (RAM) não possui permissões para chamar a operação de API.

  Soluções: Conceda as permissões necessárias ao usuário RAM. Para mais informações, consulte Gerenciar permissões de usuário RAM.

  Por exemplo, se a operação de API SendMessageToGlobe retornar o erro "You are not authorized to perform this operation", crie a seguinte política personalizada para conceder as permissões necessárias ao usuário RAM:

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

• Como resolver o erro de endpoint "PHP Fatal error: Uncaught exception 'GuzzleHttp\Exception\RequestException" com a mensagem de erro cURL error 3?

  Causas possíveis: A operação de API não suporta o endpoint especificado durante a inicialização do cliente de requisição.

  Soluções: Especifique um endpoint suportado e tente novamente. Para mais informações, consulte Configurar um endpoint.

• Como lidar com o erro de AccessKey "PHP Fatal error: Uncaught ArgumentCountError: Too few arguments to function AlibabaCloud\Credentials\AccessKeyCredential::__construct(), 1 passed and exactly 2" retornado por uma operação de API?

  Causas possíveis: O par de AccessKey não foi passado corretamente para a requisição.

  Soluções: Certifique-se de passar o par de AccessKey corretamente ao inicializar o cliente de requisição. O valor XXX em getenv("XXX") é obtido da variável de ambiente.

• Como corrigir o erro "code: 414 URL Too Long" retornado pelo Alibaba Cloud SDK?

  Causas possíveis: Esse problema não decorre do método de requisição. Ao usar o Alibaba Cloud SDK, os parâmetros de requisição são passados nas URLs. Se uma URL contiver muitos parâmetros ou valores excessivamente longos, ela pode exceder o comprimento máximo e causar falhas na requisição.

  Soluções: Para evitar URLs excessivamente longas, recomendamos usar a sintaxe de requisição e método de assinatura V3. Utilize assinaturas autoassinadas para passar parâmetros no corpo da requisição e defina o tipo de corpo como Content-Type: application/x-www-form-urlencoded.

Para mais informações sobre como tratar erros do SDK, consulte Perguntas frequentes.