Alibaba Cloud SDK：Integrasi dengan Alibaba Cloud SDK V2.0 untuk PHP

1. Masuk ke SDK Center dan pilih layanan yang SDK-nya ingin Anda gunakan. Dalam contoh ini, Short Message Service (SMS) dipilih.

2. Pada halaman Install, pilih V2.0 dari daftar drop-down SDK Generation dan klik PHP di bagian All languages. Pada tab Quick Start, dapatkan metode instalasi Short Message Service (SMS) SDK.

   

4. Tangani kesalahan

Alibaba Cloud SDK V2.0 untuk PHP mengklasifikasikan pengecualian ke dalam jenis-jenis berikut:

• TeaUnretryableException: Dalam banyak kasus, jenis pengecualian ini disebabkan oleh masalah jaringan dan dilaporkan ketika jumlah maksimum percobaan ulang tercapai.

• InvalidArgumentException: Dalam banyak kasus, jenis kesalahan ini dipicu ketika parameter yang diperlukan tidak ditentukan atau tipe parameter tidak valid. Anda dapat memeriksa pesan kesalahan untuk menemukan kesalahan.

• TeaException: Dalam banyak kasus, jenis pengecualian ini disebabkan oleh kesalahan bisnis.

Untuk informasi lebih lanjut tentang cara menangani pengecualian SDK, lihat Penanganan Pengecualian.

Skenario khusus: Unggah file melalui operasi Advance

Saat Anda menggunakan Image Search atau Visual Intelligence API (VIAPI) untuk memproses gambar di mesin lokal atau mengunggah gambar, API dari Image Search atau VIAPI yang dijelaskan dalam dokumentasi tidak mendukung pengunggahan langsung. Untuk mengunggah gambar, Anda perlu menggunakan operasi Advance, yang mendukung transmisi aliran file. Layanan cloud menyimpan file yang diunggah sementara di Object Storage Service (OSS), dan membaca file sementara dari OSS jika diperlukan. Wilayah OSS default adalah cn-shanghai. Contoh berikut menunjukkan cara memanggil operasi DetectBodyCount dari VIAPI:

1. Inisialisasi Klien Permintaan

   Pastikan bahwa parameter regionId dan endpoint layanan cloud ditentukan. regionId menunjukkan wilayah OSS tempat file sementara disimpan. Jika Anda tidak mengonfigurasi parameter regionId, layanan cloud mungkin menggunakan wilayah yang berbeda dari OSS, yang mengakibatkan timeout API.

   function createClient()
   {
       $config = new Config([
           // getenv menentukan bahwa kredensial akses diperoleh dari variabel lingkungan.
           // Diperlukan. Pastikan variabel lingkungan berikut diatur dalam lingkungan runtime kode: ALIBABA_CLOUD_ACCESS_KEY_ID. 
           "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
           // Diperlukan. Pastikan variabel lingkungan berikut diatur dalam lingkungan runtime kode: ALIBABA_CLOUD_ACCESS_KEY_SECRET. 
           "accessKeySecret" => getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET")
       ]);
       // Tentukan wilayah yang sama untuk parameter endpoint dan regionId.
       $config->endpoint = "facebody.cn-shanghai.aliyuncs.com";
       $config->regionId = "cn-shanghai";
       return new Facebody($config);
   }

2. Buat Objek Permintaan

   Buat objek permintaan <Operasi API>AdvanceRequest untuk melewati aliran file. Di objek permintaan, atur nama parameter ke ImageURLObject.

   // Baca file dan ubah menjadi objek Stream.
           $imagePath = "<FILE_PATH>";   // Ganti <FILE_PATH> dengan jalur file sebenarnya.
           try {
               $fileStream = new Stream(fopen($imagePath, "r"));
           } catch (\Exception $e) {
               die("Gagal membaca file: " . $e->getMessage());
           }
           // Buat objek permintaan dan konfigurasikan parameter permintaan.
           $detectBodyCountAdvanceRequest = new DetectBodyCountAdvanceRequest([
               "imageURLObject" =>  $fileStream
           ]);   

3. Mulai Permintaan

   Panggil operasi <Operasi API>AdvanceRequest.

   // Konfigurasikan parameter runtime.
    $runtime = new RuntimeOptions([]);
    $client = self::createClient();
    // Kirim permintaan.      
    $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([
            // Diperlukan. Pastikan variabel lingkungan berikut diatur dalam lingkungan runtime kode: ALIBABA_CLOUD_ACCESS_KEY_ID. 
            "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"),
            // Diperlukan. Pastikan variabel lingkungan berikut diatur dalam lingkungan runtime kode: 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();

        // Baca file dan ubah menjadi objek Stream.  
        $imagePath = "<FILE_PATH>";   // Ganti nilai dengan jalur file sebenarnya.
        if (!file_exists($imagePath)) {
            die("File tidak ada: $imagePath");
        }
        try {
            $fileStream = new Stream(fopen($imagePath, "r"));
        } catch (Exception $e) {
            die("Gagal membaca file: " . $e->getMessage());
        }
        // Buat objek permintaan.
        $detectBodyCountAdvanceRequest = new DetectBodyCountAdvanceRequest([
            "imageURLObject" => $fileStream
        ]);
        // Konfigurasikan pengaturan runtime.
        $runtime = new RuntimeOptions([]);
        try {
            // Kirim permintaan.
            $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

• Bagaimana cara menangani kesalahan "Anda tidak memiliki izin untuk melakukan operasi ini" yang dilemparkan oleh operasi API?

  Penyebab yang Mungkin: Pasangan AccessKey dari pengguna Resource Access Management (RAM) tidak memiliki izin untuk memanggil operasi API.

  Solusi: Berikan izin yang diperlukan kepada pengguna RAM. Untuk informasi lebih lanjut, lihat Berikan Izin kepada Pengguna RAM.

  Sebagai contoh, jika kesalahan "Anda tidak memiliki izin untuk melakukan operasi ini" dilemparkan oleh operasi API SendMessageToGlobe, buat kebijakan kustom berikut untuk memberikan izin yang diperlukan kepada pengguna RAM:

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

• Bagaimana cara menangani kesalahan "PHP Fatal error: Uncaught exception 'GuzzleHttp\Exception\RequestException" dengan pesan kesalahan endpoint yang menyebutkan cURL error 3?

  Penyebab yang Mungkin: Operasi API tidak mendukung endpoint yang Anda tentukan saat menginisialisasi klien permintaan.

  Solusi: Tentukan endpoint yang didukung dan coba lagi. Untuk informasi lebih lanjut, lihat Konfigurasikan Endpoint.

• Bagaimana cara menangani kesalahan "PHP Fatal error: Uncaught ArgumentCountError: Too few arguments to function AlibabaCloud\Credentials\AccessKeyCredential::__construct(), 1 passed and exactly 2" yang dilemparkan oleh operasi API?

  Penyebab yang Mungkin: Pasangan AccessKey tidak diteruskan dengan benar ke permintaan.

  Solusi: Pastikan pasangan AccessKey diteruskan dengan benar saat Anda menginisialisasi klien permintaan. Nilai XXX dari getenv("XXX") diperoleh dari variabel lingkungan.

• Bagaimana cara menangani kesalahan "code: 414 URL Too Long" yang dilemparkan oleh Alibaba Cloud SDK?

  Penyebab yang Mungkin: Masalah ini tidak disebabkan oleh metode permintaan. Saat menggunakan Alibaba Cloud SDK, parameter permintaan dilewatkan dalam URL. Jika URL berisi jumlah parameter yang berlebihan atau nilai parameter yang terlalu panjang, URL mungkin melebihi panjang maksimum dan menyebabkan kegagalan permintaan.

  Solusi: Untuk mencegah URL yang terlalu panjang, kami sarankan Anda menggunakan sintaks permintaan dan metode tanda tangan V3. Gunakan tanda tangan mandiri untuk melewati parameter dalam badan permintaan dan atur jenis badan ke Content-Type: application/x-www-form-urlencoded.

Untuk informasi lebih lanjut tentang cara menangani kesalahan SDK, lihat FAQ.