PHP再学习5——RESTFul框架远程控制LED-低调大师

PHP再学习5——RESTFul框架远程控制LED

2014-12-01 743

0.前言

去年（2013年）2月第一次接触yeelink平台，当时该平台已经运行了一些时间也吸引了不少极客。试想自己也将投身IoT（物联网）行业，就花了些时间研究了它。陆陆续续使用和研究了一年，大致围绕两个问题展开——1.yeelink平台如何使用，2.如何构造一个功能简单些的yeelink平台。
【 PHP学习笔记——索引博文】

本文将讨论如何构造一个简单restful架构平台（该平台有点像yeelink，不过功能比yeelink少的多），并结合树莓派实现LED的远程控制（网络控制）。构建一个RESTFul平台涉及到很多知识，通过以下链接提供一些学习资料。

【1】 Slim——简单的 PHP5 框架可用来创建 RESTful 的 Web 应用

【2】MySQL——关系型数据库管理系统

【3】 RedBean——用 NoSQL 的语法来使用 ORM 框架

【4】 JSON——轻量级的数据交换格式

【5】 cURL——利用URL语法在命令行方式下工作的开源文件传输工具

如果亲爱的读者想快速入门也可以看看我的博客文章。

【1】Slim——【 PHP再学习4—— slim框架学习和使用】

【2】cURL——【 cURL 学习笔记——结合yeelink平台】【 cURL安装和使用笔记】

【3】JSON——【 cJSON学习笔记】

【4】树莓派——【树莓派学习笔记——yeelink 远程控制LED】

【2014年3月补充】

【1】如果您想获得本篇博文的源代码， 请点击这里【 CSDN代码仓库】。 数据库操作使用RedBean。

【2】整理完本篇博文之后，修改了部分API函数并在GitHub建立了代码仓库（数据库操作并没有使用RedBean），如果本博文对您有用请点击这里【 GitHub Clone】。

【3】如果想更深入一些例如部署到云平台中，请访问我的京东云擎——【应用】 ，相关代码仓库请猛击这里【京东代码仓库】

1.REST风格API

在HTTP协议中定义了多种动作或者方法，这些方法具有不同的含义。

【GET 获取】【POST 创建】【PUT 更新】【DELTE 删除】

为了更好的理解以上的方法，下面结合LED远程控制举个例子。假设在数据库中已经保存了家庭中的LED设备信息，这些设备信息包括LED编号，LED设备描述和当前状态（打开或关闭）等，例如位于客厅的LED处于打开状态。

可通过GET方法获得某个LED设备的信息或者全部LED的信息。这些LED灯具有一个唯一的编号，例如客厅的LED灯编号为1，那么 /leds/1就是编号为1的LED设备的唯一URI(可理解为网址)。通过这样类似的方法使每个LED设备具有网址，可通过该网址访问LED。通过GET方法可获得LED设备的所有信息，这些信息可通过JSON格式描述，例如：

[{"id":1,"description":"raspberry pi IO1","status":"off"},{"id":2,"description":"raspberry pi IO2","status":"on"}]

可通过POST方法创建一个新LED，新增加的LED具体信息可使用JSON格式描述，例如：

{"description":"add a new led","status":"off"}

可通过PUT方法更新LED信息，而具体内容用JSON格式描述，例如：

{“status”:"on"}

对于LED网络控制，REST API设计如下：

GET /leds 返回所有的LED信息

POST /leds 增加一个LED设备

GET /leds/id 返回编号为id的LED设备信息

PUT /leds/id 更新编号为id的LED设备信息

2.数据库准备

2.1 修改mysql密码

【 PHP再学习4—— slim框架学习和使用】一文中推荐使用wampserver，该软件为集成安装包包括了PHP和MySQL，在使用mySQL之前最好修改默认密码，可参考博文【修改mysql密码(博主:幸好我是程序猿)】

（2.1或2.2操作也可使用phpMyAdmin）

2.1 新建LED设备表

使用mysql控制台，进入mysql数据库(输入use mysql，mysql为数据库的名称——安装wampserver后的一个默认数据库)。建立一个LED设备表，该表具有编号ID、描述description、状态status 字段，主键为id且自动增长（插入该数据表时 id写写入0或者不写，id编号会自动增长）。

[sql] view plain copy

CREATE TABLE IF NOT EXISTS `leds` (
id int(11) NOT NULL AUTO_INCREMENT,
description text NOT NULL,
status text NOT NULL,
PRIMARY KEY (id)
) DEFAULT CHARSET=utf8;

【小提示】

【1】选择数据库 use <databs_name>;

【2】查看表的结构 desc <table_name>;

【3】删除表 drop table <table_name>;

【4】id的数据类型为int(11)，千万别以为int的长度为11位，int(11)只是一种int的表达方式。

2.2 插入设备内容

可在MySQL控制台输入以下内容，插入两条数据：

[sql] view plain copy

INSERT INTO leds (id, description , status) VALUES (1, 'raspberry pi pcf8574-IO1','on');
INSERT INTO leds (id, description , status) VALUES (2, 'raspberry pi pcf8574-IO2','off');

3.GET方法获得所有LED信息

使用GET方法或的所有LED状态——GET /leds。

返回LED状态，使用JSON数据包描述。

【代码片段】

[php] view plain copy

<?php
require 'rb.php';
require 'Slim/Slim.php';
\Slim\Slim::registerAutoloader();
// 初始化数据库连接
R::setup('mysql:host=localhost;dbname=mysql','root','<your password>');
R::freeze(true);
$app = new \Slim\Slim();
// GET /leds
$app->get('/leds', function () use ($app) {
// 查找所有设备
$led_array = R::getAll('select * from leds');
$app->response()->header('Content-Type', 'application/json');
// 按照JSON格式输出
echo json_encode( $led_array , JSON_NUMERIC_CHECK);
});
$app->run();
?>

【代码解释】

【1】 require 'rb.php'; 载入redbean，请把rb.php放在www根目录。

【2】R::setup('mysql:host=localhost;dbname=mysql','root','<your password>');R::freeze(true);载入数据库，填入数据库的名称和密码。

【3】$led_array = R::getAll('select * from leds'); 查询数据库获得LED数据包的所有内容，getAll返回一个索引数组。

【4】 echo json_encode( $led_array , JSON_NUMERIC_CHECK); 请注意mysql的整形转到PHP时将变为string，如果没有JSON_NUMERIC_CHECK选项，那可能会获得{“id”:"1",....}，这肯定不是你所愿意看到的。

【简单测试】

可通过浏览器，cURL工具，浏览器HTTP插件进行测试。

图1 使用浏览器获得所有LED信息

4. GET方法获得单个LED信息

【代码片段】

[php] view plain copy

// GET /leds/:id
$app->get('/leds/:id', function ($id) use ($app) {
try {
// 查询数据库，只返回status状态
$led_single = R::getRow('select status from leds where id = :id',array(':id'=>$id));
if ($led_single) {
$app->response()->header('Content-Type', 'application/json');
// 按照JSON格式输出
echo json_encode( $led_single, JSON_NUMERIC_CHECK);
}
else {
$app->response()->status(404);
}
}
catch (ResourceNotFoundException $e) {
$app->response()->status(404);
}
catch (Exception $e) {
$app->response()->status(400);
$app->response()->header('X-Status-Reason', $e->getMessage());
}
});

【代码解释】

【1】$app->get('/leds/:id', function ($id) use ($app) id作为参数，可以输入数字1或2等。

【2】$led_single = R::getRow('select status from leds where id = :id',array(':id'=>$id));

select status from leds where id = :id 为SQL查询语句，和一般的SQL语句不同的是出现:id，array(':id'=>$id)该语句实现了SQL语句中的:id和输入参数id的绑定关系。在这里只查询status内容，其他内容忽略。

【3】echo json_encode( $led_single, JSON_NUMERIC_CHECK); JSON格式输出，请主意使用JSON_NUMERIC_CHECK选项。

【简单测试】

使用curl工具测试，在windows 控制台中输入以下命令：

curl http://localhost/leds/1

图2 使用cURL工具获得单个LED信息

5. PUT更新单个LED信息

【代码片段】

[php] view plain copy

$app->put('/leds/:id', function ($id) use ($app) {
try {
// 获得HTTP请求中的JSON数据包
$request = $app->request();
$body = $request->getBody();
$input = json_decode($body);
// 查找编号为ID的记录
$led = R::findOne('leds', 'id=?', array($id));
// 重新修改status状态，并保存
if ($led) {
$led->status = (string)$input->status;
R::store($led);
} else {
throw new ResourceNotFoundException();
}
} catch (ResourceNotFoundException $e) {
$app->response()->status(404);
} catch (Exception $e) {
$app->response()->status(400);
$app->response()->header('X-Status-Reason', $e->getMessage());
}
});

【代码分析】

【1】获得HTTP请求中的内容并进行解码，json_decode总是返回一个PHP对象而不是数组，所有后面对于input的操作需要使用->符号。

$request = $app->request();

$body = $request->getBody();

$input = json_decode($body);

【2】$led = R::findOne('leds', 'id=?', array($id)); R::findOne总是返回一个对象，后面的操作需要使用->符号。

【3】$led->status = (string)$input->status; 修改status。

【4】R::store($led); 重新存储led信息。

【简单测试】

使用cURL工具测试，请求的内容为{"status":"off"}，请求的方法为PUT。在windows控制台下输入以下命令：

curl -i --request PUT --data "{\"status\":\"on\"}" http://localhost/leds/1

注意：1）由于该HTTP负载并没有返回值，所有curl指令中加入-i选项，意为显示HTTP响应首部。

2）PUT方法必须大写。

图3 使用cURL更新单个LED状态

图4 编号为1的LED状态发生改变

6.树莓派实现LED网络控制

亲爱的朋友，如果您还不熟悉树莓派的话，可以参考：

【树莓派学习笔记——GPIO功能学习】

【树莓派学习笔记——yeelink 远程控制LED】

通过树莓派实现网络控制的方法也非常简单，树莓派不停的向服务器（在局域网中，IP为192.168.1.100）发送GET请求，服务器查询数据库以JSON格式返回LED信息，树莓派根据JSON数据包的内容控制LED灯，on为点亮，off为熄灭。

【1】树莓派发送HTTP请求 GET /leds/1

【2】服务器返回HTTP响应 {“status”:"off"}或{“status”:"on"}

【3】树莓派根据status控制LED设备

【代码片段】

[python] view plain copy

#!/usr/bin/env python
# -*- coding: utf-8 -*-
import requests
import smbus
import RPi.GPIO as GPIO
import time
# 打开 /dev/i2c-1
bus = smbus.SMBus(1)
# 设备URI
apiurl = 'http://192.168.1.100/leds/1'
while True:
#发送请求
r = requests.get(apiurl)
# 打印内容
print(r.text)
# 响应转换内容为字典形式
# 转换为字典类型请注意 2.7.4版本使用r.json()
led = r.json
# {'value':'xx'} on打开状态，off关闭状态
if led['status'] == 'on':
print("led on")
bus.write_byte( 0x20 , 1 )
else:
print("led off")
bus.write_byte( 0x20 , 0 )
# 延时5S
time.sleep(5)

【代码测试】

由于没有做前端，所有只能通过cURL指令改变LED的status。改变数据库中LED的status之后，树莓派上扩展板的真实LED状态便会发生变化。前端控制页面请期待后续博文。

图5 测试结果LED状态发生改变

7.其他遐想

本文只是想阐述REST框架的创建和使用，树莓派的使用并不是本文的重点（树莓派让我扩展了知识面）。除了树莓派之外还可以使用其他设备“享用”这个REST服务，例如

arduino平台——入门简单，加上ENC28J60可替代本文树莓派的功能。

STM32平台——【 Yeelink平台使用——远程控制 RT Thread + LwIP+ STM32】简单修改该博客中的代码便可实现树莓派远程控制一样的功能，但是使用STM32平台需要更多的嵌入式方面的知识。

8.参考资料

【1】【 Create REST applications with the Slim micro-framework】

【2】【 RESTful services with jQuery, PHP and the Slim Framework】

【3】 yeelink API文档

9.关于我自己

本人是一名嵌入式工程师，专注于物联网领域。虽然是一名嵌入式工程师，但是由于物联网的多领域交叉性，不得不让自己多学一些WEB方面的知识。对于工程师来说学习新的知识绝对是有必要的， 工程师没过过去只有去创造。

Email:xukai19871105@126.com

微信关注我们

原文链接：https://yq.aliyun.com/articles/586377

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

5G和千兆宽带离民用还有多远？

就在土豪们的iphone6刚刚拿到手还没捂热，iphone7的谍照就开始曝光了。如同运营商们正在如火如荼地搭建4G，5G又开始被炒了起来。4G一夜之间就像个弃儿，这种刚刚以为自己登上顶峰，瞬间发现已落伍，欣喜紧跟着哀愁的跌宕起伏的心情，大概你我都能明了。眼看着无线网络进入5G时代，还有同样不甘心的民营运营商也炒起了千兆宽带的概念，这一切快得让还停留在3G网络及8M宽带的笔者，来不及分清是幻境还是现实。看起来更像是炒作？为何5G会被提上日程？因为物联网。由于智能终端的发展，很多的工作和生活可以通过终端来解决。据统计全球已经有140亿终端连接起来，但当今世界还有90%的东西未被连接。一如传言物联网将是未来真正的杀手级应用。它需要的是“人与物”、“物与物”之间的高速连接，这就需要更高速的无线网络支撑，而5G能够满足这一切。虽然5G目前还只是个概念，但是运营商和设备商早已把5G描绘的天花乱坠，诸如5G相当于4G网络速率的100倍。在5G网络环境下，一部超高清画质的电影1秒内就可以搞定。它的典型应用场景从超高清、3D全息视频到智能家居、从智能监控到智能驾驶、从虚拟现实到智能传感器等。仿佛到...

2014-11-29

645

物联网学习笔记——构建RESTFul平台1

0.前言前些时间顺着Yeelink学习了RESTFUL，使用PHP和Slim框架尝试实现简单的REST API，树莓派可通过GET方法获得JSON数据包，通过这种方式实现了树莓派和服务器（我的PC）的互动。但是由于没有WEB前端，所以只能使用cURL工具或直接修改数据库的方式改变LED状态，体验非常差。 REST API入门体验可参考【 PHP再学习4—— slim框架学习和使用】【 PHP再学习5——RESTFul框架远程控制LED】受到【开源IOT——一个最小的物联网系统设计方案及源码】一文的影响。我决定除了服务器和嵌入式侧之外，我应该再多做一些。 WEB前端涉及到非常多的知识，下面提供一些学习资料。下面各种技术您可能不知道但是您一定用过。【HTML】——超文本标记语言【CSS】——级联样式表，能够对网页中的对象的位置排版进行像素级的精确控制【Javascript】——网络的脚本语言【Jquery】——JavaScript 库，极大地简化了 JavaScript 编程【Ajax】——异步的 JavaScript 和 ...

2014-12-02

618

发表评论

资源下载

更多资源

优质分享App

近一个月的开发和优化，本站点的第一个app全新上线。该app采用极致压缩，本体才4.36MB。系统里面做了大量数据访问、缓存优化。方便用户在手机上查看文章。后续会推出HarmonyOS的适配版本。

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Rocky Linux

Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。