Uso de IoT Platform SDK for PHP - IoT Platform - Centro de documentación de Alibaba Cloud

Aprenda a instalar, configurar y usar IoT Platform SDK for PHP para llamar a las operaciones de la API de IoT Platform.

Instalar el SDK

IoT Platform SDK for PHP forma parte de Alibaba Cloud SDK for PHP. Si ya instaló Alibaba Cloud SDK for PHP, omita esta sección.

Instale un entorno de desarrollo de PHP.

Se requiere PHP 5.5.0 o una versión posterior. Descargue e instale PHP desde el sitio web oficial de PHP.
Instale Composer.
Composer gestiona la dependencia de IoT Platform SDK for PHP.
- En Windows, descargue y ejecute Composer-Setup.exe desde getcomposer.org.
- Como alternativa, ejecute el siguiente comando curl:
```
curl -sS https://getcomposer.org/installer | php
```
Nota
Si la instalación falla por problemas de red, utilice el espejo de Composer de Alibaba Cloud.
Agregue la dependencia de IoT Platform SDK for PHP:
```
composer require alibabacloud/iot
```
El código fuente y la documentación están disponibles en los repositorios de GitHub openapi-sdk-php-iot y Alibaba Cloud SDK for PHP.

Inicializar el SDK

A continuación se muestra un ejemplo de cómo inicializar el SDK para llamar a una API en la región China (Shanghai).

Cree un objeto $iClientProfile con su región y sus credenciales. Después, páselo a DefaultAcsClient($iClientProfile) para inicializar el cliente.

include_once 'aliyun-php-sdk-core/Config.php';
use \Iot\Request\V20180120 as Iot;
// Set your AccessKey ID, AccessKey secret, and ProductKey.
$accessKeyId = getenv('ACCESS_KEY_ID');
$accessSecret = getenv('ACCESS_KEY_SECRET');
$iClientProfile = DefaultProfile::getProfile("cn-shanghai", $accessKeyId, $accessSecret);
$client = new DefaultAcsClient($iClientProfile);

Parámetro

Descripción

$iClientProfile

Almacena la información de inicialización del SDK. cn-shanghai es el identificador de la región donde reside su instancia de IoT Platform.

Consulte su región en la esquina superior izquierda de la consola de IoT Platform.

Todos los identificadores de región disponibles se enumeran en Supported regions.

Iniciar una solicitud

Cada operación de la API tiene una clase correspondiente llamada ${API operation name}+"Request". Cree una instancia de $request, establezca los parámetros con los métodos "set"+${Request parameter} y llame a getAcsResponse($request) para obtener la respuesta.

La lista de API de nube de IoT Platform se encuentra en API list. Para consultar la descripción de los parámetros de solicitud en request y los parámetros de respuesta en response, consulte la referencia de la API correspondiente.

Este tema utiliza la operación Pub como ejemplo para mostrar cómo publicar un mensaje en un topic. Para obtener información sobre los parámetros de solicitud, consulte Pub.

Importante

En el siguiente código, ${iotInstanceId} representa el identificador de la instancia. Encuentre el ID de la instancia actual en la página Instance Overview de la consola de IoT Platform.

Si existe un identificador, debe pasarlo. De lo contrario, la llamada a la API fallará.
Si no existe la página Instance Details ni el identificador, no necesita pasar ningún identificador. Elimine el código de solicitud relacionado con IotInstanceId o pase un valor vacío "". De lo contrario, la llamada a la API fallará.

Para obtener más información sobre las instancias, consulte Instance overview. Para saber cómo comprar una instancia, consulte Purchase an Enterprise instance. Las preguntas frecuentes se encuentran en FAQ about IoT Platform instances.

$request = new Iot\PubRequest();
$request->setIotInstanceId("iotInstanceId"); 
$request->setProductKey("productKey");
$request->setMessageContent("aGVsbG93b3JsZA="); //hello world Base64 String.
$request->setTopicFullName("/productKey/deviceName/get"); // The full name of the topic that is used to publish the message.
$response = $client->getAcsResponse($request);
print_r($response);

Apéndice: Código de ejemplo

Vaya al Centro de ejemplos de Cloud SDK de IoT Platform para consultar o descargar código de ejemplo para las llamadas a la API. El código de ejemplo incluye muestras para los SDK de Java, Python, PHP, .NET y Go.

El Portal para desarrolladores de OpenAPI de Alibaba Cloud proporciona un online API debugging tool. En la página API debugging, puede buscar y probar llamadas a la API. El portal genera automáticamente código de ejemplo del SDK en distintos lenguajes según los parámetros que introduzca. Consulte el código generado en la pestaña SDK Example y la respuesta en la pestaña Call Result.