PHP:打造 JSON 数据接口的 Web 服务器

Table of Contents

<a id=”1″></a>前言

在采纳开发的进程中,涉及网络,日常就须求通过有些 HTTP
请求从网上获取数据。很多网络服务器(Web server)提供了 URL 类型的
API,通过访问特定的 URL,就能从服务器重临数据,比如:

http://api.openweathermap.org/data/2.5/weather?q=London,uk&appid=b1b15e88fa797225412429c1c50c122a1

在浏览器访问上面那几个链接,服务器就会再次回到数据。重返的数据类型有那几个种,如:JSON,XML等。

本文目的在于通过一个例子简要介绍那种服务器程序的打造,最终落成一个服务器程序,已毕通过
URL 与服务器通信,服务器重临 JSON 格式的数额。

<a id=”2″></a>难题及要求分析

<a id=”21″></a>API

观测地点的 URL,大家得以窥见它可以分成八个部分。

一是主机地址:http://api.openweathermap.org/data/2.5/weather

二是参数:q=London,uk&appid=b1b15e88fa797225412429c1c50c122a1

长机地址和参数之间用 ? 隔开。参数又有什么不可分成七个独立的参数。在这一个 URL
中,共包蕴了多少个参数,分别是 qappid,等号后边是参数的值。

俺们要做的是一个物联网温度传感器的后台服务器,即基于分化的
URL,再次来到温度数据或储存温度数据。

假设大家的 API 如下:

获取最近的一个温度数据 API:
http://localhost:8888/temperature.php?key=lsw&query=get
返回示例(JSON):
成功:{"status":true,"date":"2016-11-17 19:13:09","value":32.63}
失败:{"status”:false,”message”:”*"}
备注:”value” 的数据类型是 double

上传一个温度数据 API:
http://localhost:8888/temperature.php?key=lsw&query=set&value=27.1
返回示例(JSON):
成功:{"status":true,"message":"setting success"}
失败:{"status”:false,”message”:”*"}

URL 中的 temperature.php 就是大家即将编写的网页文件。key 和 query
是五个参数,在 query=set 时,还应涵盖 value 参数。重回的数据类型是
JSON,以 status 标志操作是还是不是中标,以及附带有音信或数额。

<a id=”22″></a>JSON 数据

JSON(JavaScript
Object Notation)
是一种轻量级的数据调换格式。它基于ECMAScript的一个子集。
JSON选用完全独立于言语的文本格式,然则也采纳了类似于C语言家族的习惯(包罗C、C++、C#、Java、JavaScript、Perl、Python等)。那几个特征使JSON成为杰出的数据沟通语言。
易于人读书和编制,同时也便于机器解析和生成(一般用来升级网络传输速率)。

JSON 数据是足以包罗数据类型的,如上边重返示例中的 value 是一个 double
类型的数码。

<a id=”3″></a>实现

<a id=”31″></a>本地服务器开发条件:MAMP

MAMP
是经典本地服务器环境的 Mac OS 软件。MAMP 那多少个首字母代表苹果的 Mac OS
系统上的 Macintosh、Apache、MySQL 和 PHP。在 Windows
系统上也有对应的付出环境,WAMP。这里以 MAMP 为例进行表明。

MAMP 分免费版和专业版,大家眼前只必要用到免费版。安装完毕后运行,点击
Start Servers
就足以运作本地的服务器。默许的地方服务器地址是:http://localhost:8888

在 MAMP 的 Preferences.. -> Web Server -> Document Foot
可以一定到服务器源文件目录。服务器的程序就保留在这一个目录里。

<a id=”32″></a>后台数据库 MySQL

为了存储数据,服务器须要有一个数据库,并完成与数据库之间的通讯。首先大家用
MAMP 运行本地的服务器,在打开的导航网页中开辟数据库的军事管制页面。

新建一个名为 temperatureData 的数据库,再新建一个多少表
temperature,并累加如下字段:

如此就形成了数据库的布署,近年来只须求仓储温度信心,因而只布署那多少个条目。

<a id=”33″></a>服务器程序

有了数据库,接下去就要写服务器程序了。服务器程序需求形成以下多少个部分的情节:

  1. 连年数据库,与数据库通讯,完结多少的读取与仓储。
  2. 赢得 URL 中的参数,按照差其他参数和参数值执行相应的操作。
  3. 打包要赶回的音信,以 JSON 方式重返。

实际的先后如下,在显要的地方以注释的点子展开认证。

<?php
    //函数:用于把数据封装为 JSON 格式
    function echoJSON($withStatus,$andMessage){
        $data = array('status' => $withStatus, 'message' => $andMessage);
        $jsonstring = json_encode($data);
        header('Content-Type: application/json');
        echo $jsonstring;
    }
    // 配置数据库
    $user = 'root';
    $password = 'root';
    $db = 'temperatureData';
    $host = 'localhost';
    $port = 8889;
    $link = mysqli_init();
    $success = mysqli_real_connect(
                                   $link,
                                   $host,
                                   $user,
                                   $password,
                                   $db,
                                   $port
                                   );
    $privateKey = "lsw";
    if($success){
    //与数据库连接成功后,获取 URL 中的参数值,根据参数执行相应的程序。如:$_GET["key"] 用于获取 URL 中 "key" 的参数值。
        $key = $_GET["key"];
        if($key == $privateKey){
            $query = $_GET["query"];
            switch ($query){
                case "get":
                    $result = mysqli_query($link,"SELECT * FROM `Temperature`");
                    $row = mysqli_fetch_array($result);

                    $data = array('status' => true, 'date' => $row["Date"], 'value' => (double)$row["Value"]);
                    $jsonstring = json_encode($data);
                    header('Content-Type: application/json');
                    echo $jsonstring;
                    break;
                case "set":
                    $value = $_GET["value"];
                    $valueDouble = (double)$value;
                    if($valueDouble){
                        mysqli_query($link,"DELETE FROM `Temperature` WHERE 1");
                        mysqli_query($link,"INSERT INTO `Temperature`(`Date`, `Value`) VALUES (CURRENT_TIMESTAMP,$valueDouble);");
                        $data = array('status' => true, 'message' => 'setting success');
                        $jsonstring = json_encode($data);
                        header('Content-Type: application/json');
                        echo $jsonstring;
                    }else{
                        echoJSON(false,"invalid value");
                    }
                    break;
                default:
                    echoJSON(false,"unsupported query");
            }
        }else{
            echoJSON(false,"invalid key");
        }
    }else{
        echoJSON(false,"Connect Error: " . mysqli_connect_error());
    }
    // 关闭数据库连接。
    mysqli_close($link);
?>

在服务器目录里新建一个 temperature.php
文件,将上述顺序复制到文件中保存。用 MAMP
运行服务器,上面将检察大家服务器的安排情形。

在浏览器中走访:http://localhost:8888/temperature.php?key=lsw&query=get
就能获取数据库中的温度音讯。如若数据库中还尚无温度消息,则会回到如下结果:

{"status":true,"date":null,"value":0}

在浏览器中显得如下:

全体的顺序请看这里

有关什么使用这么些 Web 服务器已毕物联网温度传感器,请参见:LOT|物联网
温度传感器

有其余疑问的话,欢迎在凡间评论区研商。

附上自己的Github:LinShiwei (Lin Shiwei) ·
GitHub