Alibaba Cloud SDK:Alibaba Cloud SDK V2.0 for PHP ile Entegrasyon

1. SDK Center adresine gidin ve SDK'sını kullanmak istediğiniz hizmeti seçin. Bu örnekte Short Message Service (SMS) seçilmiştir.

2. Install sayfasında , SDK Generation açılır listesinden V2.0 seçeneğini belirleyin ve All languages bölümünde PHP seçeneğine tıklayın. Quick Start sekmesinde Short Message Service (SMS) SDK'sının yükleme yöntemini edinin.

   

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. Hataları işleme

Alibaba Cloud SDK V2.0 for PHP özel durumları aşağıdaki türlere ayırır:

• TeaUnretryableException: Bu tür özel durum çoğunlukla ağ sorunlarından kaynaklanır ve maksimum yeniden deneme sayısına ulaşıldığında bildirilir.

• InvalidArgumentException: Bu tür hata çoğunlukla gerekli bir parametre belirtilmediğinde veya parametre türü geçersiz olduğunda tetiklenir. Hatayı bulmak için hata message değerini kontrol edebilirsiniz.

• TeaException: Bu tür özel durum çoğunlukla iş mantığı hatalarından kaynaklanır.

SDK özel durumlarının nasıl işleneceği hakkında daha fazla bilgi için bkz. Özel durum işleme.

Özel senaryo: Advance işlemi aracılığıyla dosya yükleme

Image Search veya Visual Intelligence API (VIAPI) kullanarak yerel makinedeki görüntüleri işlerken veya görüntüleri yüklerken belgede açıklanan Image Search veya VIAPI API'si doğrudan yüklemeyi desteklemez. Görüntüleri yüklemek için dosya akışlarının iletilmesini destekleyen Advance işlemini kullanmanız gerekir. Cloud hizmeti yüklenen dosyayı geçici olarak Object Storage Service (OSS) içinde depolar ve gerektiğinde geçici dosyayı OSS'ten okur. OSS'in varsayılan bölgesi cn-shanghai olarak ayarlanmıştır. Aşağıdaki örnekte VIAPI'nin DetectBodyCount işleminin nasıl çağrılacağı gösterilmektedir:

1. Bir istek istemcisini başlatma

   Hizmetin hem regionId parametresinin hem de endpoint değerinin belirtildiğinden emin olun. regionId geçici dosyaların depolandığı OSS bölgesini belirtir. regionId parametresini yapılandırmazsanız cloud hizmeti OSS'ten farklı bir bölge kullanabilir ve bu durum API zaman aşımlarına neden olabilir.

   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. Bir istek nesnesi oluşturma

   Dosya akışlarını iletmek için <API işlemi>AdvanceRequest istek nesnesini oluşturun. İstek nesnesinde parametre adını ImageURLObject olarak ayarlayın.

   // 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. Bir istek başlatma

   <API işlemi>AdvanceRequest işlemini çağırın.

   // 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();

SSS

• Bir API işlemi tarafından oluşan "You are not authorized to perform this operation" hatasını nasıl işlerim?

  Olası nedenler: Resource Access Management (RAM) kullanıcısının AccessKey çifti API işlemini çağırma iznine sahip değil.

  Çözümler: RAM kullanıcısına gerekli izinleri verin. Daha fazla bilgi için bkz. RAM kullanıcı izinlerini yönetme.

  Örneğin SendMessageToGlobe API işlemi "You are not authorized to perform this operation" hatası veriyorsa RAM kullanıcısına gerekli izinleri vermek için aşağıdaki özel ilkeyi oluşturun:

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

• Hata iletisi cURL error 3 olan "PHP Fatal error: Uncaught exception 'GuzzleHttp\Exception\RequestException" uç nokta hatasını nasıl işlerim?

  Olası nedenler: API işlemi istek istemcisini başlatırken belirttiğiniz uç noktayı desteklemiyor.

  Çözümler: Desteklenen bir uç nokta belirtin ve tekrar deneyin. Daha fazla bilgi için bkz. Uç nokta yapılandırma.

• Bir API işlemi tarafından oluşan "PHP Fatal error: Uncaught ArgumentCountError: Too few arguments to function AlibabaCloud\Credentials\AccessKeyCredential::__construct(), 1 passed and exactly 2" AccessKey hatasını nasıl işlerim?

  Olası nedenler: AccessKey çifti isteye doğru şekilde iletilmemiş.

  Çözümler: İstek istemcisini başlatırken AccessKey çiftinin doğru şekilde iletildiğinden emin olun. getenv("XXX") içindeki XXX değeri ortam değişkeninden alınır.

• Alibaba Cloud SDK tarafından oluşan "code: 414 URL Too Long" hatasını nasıl işlerim?

  Olası nedenler: Bu sorun istek yönteminden kaynaklanmaz. Alibaba Cloud SDK'yı kullanırken istek parametreleri URL'lerde iletilir. Bir URL aşırı sayıda parametre veya çok uzun parametre değerleri içeriyorsa URL maksimum uzunluğu aşabilir ve istek başarısız olabilir.

  Çözümler: Çok uzun URL'leri önlemek için istem sözdizimi ve imzalama yöntemi V3 kullanmanızı öneririz. Parametreleri istek gövdesinde iletmek için kendi kendine imzalı imzalar kullanın ve gövde türünü Content-Type: application/x-www-form-urlencoded olarak ayarlayın.

SDK hatalarının nasıl işleneceği hakkında daha fazla bilgi için bkz. SSS.