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

1. Acesse o Centro de SDK e selecione o service cujo SDK você deseja usar. 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).

   

4. Trate erros

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

• TeaUnretryableException: Na maioria dos casos, esse tipo de exceção é causado por problemas de rede e é reportado quando o número máximo de tentativas é atingido.

• InvalidArgumentException: Na maioria dos casos, esse tipo de erro é acionado quando um parâmetro obrigatório não é especificado ou o tipo do parâmetro é inválido. Você pode verificar o message do erro para localizar o erro.

• TeaException: Na maioria dos casos, esse tipo de exceção é causado por erros de negócio.

Para mais informações sobre como tratar exceções do SDK, consulte Exception handling.

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

Ao usar o Image Search ou o Visual Intelligence API (VIAPI) para processar imagens em uma máquina local ou fazer upload de imagens, a API do Image Search ou VIAPI descrita na documentação não suporta upload direto. Para fazer upload de imagens, você precisa usar a operação Advance, que suporta a transmissão de fluxos de arquivos. O cloud service 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. Inicialize um client de requisição

   Certifique-se de que tanto o parâmetro regionId quanto o endpoint do cloud service estejam especificados. 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 cloud service poderá usar uma região diferente 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. Crie um objeto de requisição

   Crie o objeto de requisição <API operation>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. Inicie uma requisição

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

FAQ

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

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

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

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

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

• Como trato o erro de endpoint "PHP Fatal error: Uncaught exception 'GuzzleHttp\Exception\RequestException" cuja mensagem de erro é cURL error 3?

  Causas possíveis: A operação de API não suporta o endpoint que você especifica ao inicializar o client de requisição.

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

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

  Causas possíveis: O AccessKey pair não é passado corretamente para a requisição.

  Soluções: Certifique-se de que o AccessKey pair seja passado corretamente ao inicializar o client de requisição. O valor XXX de getenv("XXX") é obtido da variável de ambiente.

• Como trato o erro "code: 414 URL Too Long" lançado pelo Alibaba Cloud SDK?

  Causas possíveis: Este problema não é causado pelo método de requisição. Ao usar o Alibaba Cloud SDK, os parâmetros de requisição são passados em URLs. Se uma URL contiver um número excessivo de parâmetros ou valores de parâmetros muito longos, a URL pode exceder o comprimento máximo e causar falhas na requisição.

  Soluções: Para evitar URLs muito longas, recomendamos que você use request syntax and signature method V3. Use assinaturas autoassinadas para passar parâmetros no corpo da requisição e defina o tipo do corpo como Content-Type: application/x-www-form-urlencoded.

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