手把手学IOT服务端API编程[1、创建产品][step by step ALI-IOT-SERVER-API]

阿里云的物联网架构主要分为设备端和服务端，
本教程旨在介绍服务器端的API编程接口，基于php脚本的sdk，希望对物联网服务器端有编程需求的有所帮助。


由于涉及到php脚本编程，所以首先是要有一套php脚本解释器的环境，通常是使用阿里云的ecs服务器搭建一套LNMP[linux,nginx,mysql,php]环境，
这样可以通过远程网页，显示我们php运行的结果，具体环境搭建可以参考ecs板块相关教程；
当然也可以使用笔者的演示网址: www.xunyun17.xyz/ioto/frm1.php


另外，如果需要通过api操作服务端的相关服务，需要下载相应的sdk，php脚本在github上有所有阿里云产品的sdk，直接通过如下git命令可以获取：


git clone https://github.com/aliyun/aliyun-openapi-php-sdk.git
由于下载下来的目录包含了所有云产品的接口，我们只需要物联网iot和core核心的sdk即可，所以单独将这两个目录移出来，然后删除冗余的目录，
这个可以通过如下三条命令实现：


mv aliyun-openapi-php-sdk/aliyun-php-sdk-core/ -f .
mv aliyun-openapi-php-sdk/aliyun-php-sdk-iot/ -f .
rm aliyun-openapi-php-sdk/ -rf


环境搭建好了后，我们就可以编写我们自己的php脚本，调用相关的api，来进行相应功能的开发了；
今天我们先来看第一个api：创建产品[CreateProductRequest]，提到产品这个概念，要先介绍一下阿里云物联网的相关定义，按照设备的功能和
特性不同，通常将功能类似的设备划分为一类产品，比如输入
产品，输出产品，也可以分成发光产品，温度产品。。。，具体是用户根据自己的实际
情况和环境来划分的，然后每类产品下再创建若干的设备；其实产品和设备的关系也可以理解成目录和文件的关系；每个文件一般是属于某一个目录
的，所以每种设备也是属于每一类产品。如果要使用创建产品的api，我们需要提供两个参数：产品名称和产品描述；这个也比较容易理解产品名称
通常是这一类设备的通用功能的简称，而产品描述则是对这类产品的一个详细描述；


另外，由于安全考虑，凡是调用阿里云restful的api，都需要提供access key的id和secret，这个可以在个人控制台中找到；
这里用两个php脚本来实现，一个是frm文件，可以通过让用户在网页上动态输入不同的内容来创建不同的产品。另一个脚本则是ex文件，是要实现
调用相关api功能的操作；
下面大概看一下frm 文件：除了一些显示信息外，还提供了两个文本框，用于输入产品的名称和描述：
产品名称:        <input type="text" name="pname1">
产品描述:    <input type="text" name="pdesc1">


而在我们的ex文件里，则通过get函数得到用户输入的值：


$pname1 = $_GET["pname1"];
$pdesc1 = $_GET["pdesc1"];


然后通过
$request = new Iot\CreateProductRequest();
$request->setName($pname1);
$request->setDesc($pdesc1);
接口将配置信息传递到sdk中，再通过运行命令
$response = $client->getAcsResponse($request);
将信息发送给服务器，并通过下面的命令打印相关的返回信息：
echo 'RequestId ：'.$response->RequestId.'<br>';
echo 'Success ：'.$response->Success.'<br>';
echo 'ProductKey ：'.$response->ProductInfo->ProductKey.'<br>';
echo 'ProductDesc ：'.$response->ProductInfo->ProductDesc.'<br>';
echo 'ProductName ：'.$response->ProductInfo->ProductName.'<br>';


当我们编写好这两个脚本后，在网页上运行一下，输入我们想要得产品名称和产品描述，




再到我们的iot控制台，察看一下是否有按照我们的
要求，创建了相关的设备：






frm,ex文件：


timelapse:  [ 特别声明：本视频演示中，所用到的Access-key-secret为演示使用，已经禁用，实际试验操作，请使用自己账号的Acess-key-id,secret]
http://www.xunyun17.xyz/ioto/step1.mp4