IoT Platform menyediakan SDK untuk PHP. Dokumen ini menjelaskan cara menginstal dan mengonfigurasi IoT Platform SDK untuk PHP serta memberikan contoh kode untuk memanggil operasi API dari IoT Platform.
Instal SDK
IoT Platform SDK untuk PHP merupakan bagian dari Alibaba Cloud SDK untuk PHP. Jika Anda telah menginstal Alibaba Cloud SDK untuk PHP, tidak perlu menginstal IoT Platform SDK secara terpisah.
Instal lingkungan pengembangan PHP.
PHP versi 5.5.0 atau lebih baru didukung. Unduh paket instalasi PHP dari situs resmi PHP dan instal PHP.
Instal Composer.
Composer digunakan untuk mengelola dependensi IoT Platform SDK untuk PHP. Oleh karena itu, Anda harus menginstal Composer di sistem Anda.
Untuk pengguna Windows, unduh program Composer-Setup.exe dari situs getcomposer.org dan instal Composer.
Alternatifnya, jalankan perintah curl berikut untuk menginstal Composer:
curl -sS https://getcomposer.org/installer | php
CatatanJika instalasi gagal karena masalah jaringan, gunakan mirror penuh Alibaba Cloud Composer.
Tambahkan dependensi berikut untuk menginstal IoT Platform SDK untuk PHP:
composer require alibabacloud/iotUntuk informasi lebih lanjut, kunjungi openapi-sdk-php-iot dan Alibaba Cloud SDK untuk PHP.
Inisialisasi SDK
Contoh berikut menunjukkan cara menginisialisasi SDK jika layanan IoT Platform Anda berada di wilayah Tiongkok (Shanghai):
Buat objek $iClientProfile untuk menyimpan informasi inisialisasi SDK. Kemudian, buat instance $client dari kelas DefaultAcsClient. Gunakan metode DefaultAcsClient($iClientProfile) untuk memuat informasi inisialisasi SDK.
include_once 'aliyun-php-sdk-core/Config.php';
use \Iot\Request\V20180120 as Iot;
// Setel ID AccessKey Anda, Rahasia AccessKey, dan ProductKey.
$accessKeyId = getenv('ACCESS_KEY_ID');
$accessSecret = getenv('ACCESS_KEY_SECRET');
$iClientProfile = DefaultProfile::getProfile("cn-shanghai", $accessKeyId, $accessSecret);
$client = new DefaultAcsClient($iClientProfile);
Parameter | Deskripsi |
$iClientProfile | Objek yang digunakan untuk menyimpan informasi inisialisasi SDK. Anda dapat melihat wilayah tersebut di pojok kiri atas Konsol IoT Platform. Untuk informasi lebih lanjut tentang ID wilayah, lihat Wilayah yang didukung. |
Ajukan permintaan
SDK membungkus sebuah kelas untuk setiap operasi API. Nama kelasnya dalam format ${Nama Operasi API}+"Request". Anda dapat menggunakan kelas tersebut untuk mengajukan permintaan API. Buat instance $request dari kelas ini dan panggil metode "set"+${Parameter Permintaan} untuk menentukan parameter permintaan. Lalu, gunakan metode getAcsResponse($request) dari instance $client untuk mendapatkan respons.
Untuk informasi lebih lanjut tentang operasi API dari IoT Platform, lihat Daftar operasi berdasarkan fungsi. Untuk detail parameter request dan response dari setiap operasi API, lihat dokumentasi API.
Contoh berikut menunjukkan cara memanggil operasi Pub untuk mempublikasikan pesan ke topik. Untuk informasi lebih lanjut tentang parameter permintaan, lihat Pub.
Dalam kode sampel berikut, ${iotInstanceId} menentukan ID suatu instance. Anda dapat melihat ID instance di halaman Ikhtisar di Konsol IoT Platform.
Jika instance Anda memiliki ID, Anda harus menentukan ID untuk parameter ini. Jika tidak, permintaan akan gagal.
Jika tidak ada halaman Ikhtisar atau ID yang dihasilkan untuk instance Anda, Anda tidak perlu menentukan parameter ini. Hapus kode permintaan yang terkait dengan parameter IotInstanceId atau tentukan string kosong (
"") untuk parameter tersebut. Jika tidak, permintaan akan gagal.
Untuk informasi lebih lanjut tentang instance IoT Platform, lihat Ikhtisar. Untuk informasi lebih lanjut tentang cara membeli instance, lihat Beli instance Edisi Perusahaan. Untuk informasi lebih lanjut tentang pertanyaan yang sering diajukan, lihat FAQ tentang instance IoT Platform.
$request = new Iot\PubRequest();
$request->setIotInstanceId("iotInstanceId");
$request->setProductKey("productKey");
$request->setMessageContent("aGVsbG93b3JsZA="); //hello world Base64 String.
$request->setTopicFullName("/productKey/deviceName/get"); // Nama lengkap topik yang digunakan untuk mempublikasikan pesan.
$response = $client->getAcsResponse($request);
print_r($response);Lampiran: Contoh kode
Anda dapat melihat atau mengunduh contoh kode operasi API di IoT Platform SDK Sample Center. Contoh kode SDK untuk Java, Python, PHP, .NET, dan Go disediakan.
OpenAPI Explorer Alibaba Cloud menyediakan alat debugging online untuk operasi API. Di halaman Debugging API, Anda dapat mencari operasi API, memanggil operasi API, dan menghasilkan contoh kode untuk operasi API dari berbagai SDK. Di sisi kanan halaman, Anda dapat melihat contoh kode SDK di tab Sample Code. Di tab Hasil Debugging, Anda dapat melihat URL permintaan sebenarnya dan respons dalam format JSON.