如何建立一个RESTful API？ [英] How to build a RESTful API?
问题描述
问题是这样的：
我有一个PHP的服务器上运行的Web应用程序。我想建立一个REST API它。结果
我做了一些研究，我想通了，REST API使用HTTP方法（GET，POST ...）对于某些URI与验证密钥（不一定）和信息psented追溯到与信息作为HTTP响应$ P $ XML或JSON（我宁愿JSON）。
我的问题是：
- 如何，作为应用程序的开发者，构建这些URI的？我是否需要在该URI来写一个PHP code？
- 如何构建JSON对象返回作为响应？
下面是简单的PHP非常简单的例子。
有2个文件的 client.php ＆安培; api.php 。我把两个文件在同一网址：的http：//本地主机：8888 / ，所以你必须将链接改为自己的URL。 （该文件可以在两台不同的服务器）。
这只是一个例子，这是非常快速和肮脏的，再加上它已经很长一段时间，因为我已经做了PHP。但是，这是一个API的想法。
client.php
＆LT; PHP/ ***这是客户*** /
如果（使用isset（$ _ GET [行动]）及和放大器;使用isset（$ _ GET [身份证]）及和放大器; $ _GET [行动] ==GET_USER）//如果get参数动作是GET_USER，如果ID设置，调用API来获取用户信息
{
$ USER_INFO =的file_get_contents（的http：//本地主机：8888 / api.php行动= GET_USER和ID ='$ _GET [身份证]）;
$ USER_INFO = json_de code（$ USER_INFO，真正的）; //这是非常快速和肮脏的!!!!!
？＆GT;
＆LT;表＆gt;
＆所述; TR＆GT;
＆所述; TD＆GT;名称：其中; / TD＆GT;＆下; TD＆GT; ＆LT;？PHP的echo $ USER_INFO [姓氏]＆GT;＆LT; / TD＆GT;
＆LT; / TR＆GT;
＆所述; TR＆GT;
＆所述; TD＆gt;首先名称：其中; / TD＆GT;＆下; TD＆GT; ＆LT;？PHP的echo $ USER_INFO [如first_name]＆GT;＆LT; / TD＆GT;
＆LT; / TR＆GT;
＆所述; TR＆GT;
＆LT; TD＆GT;年龄：＆LT; / TD＆GT;＆LT; TD＆GT; ＆LT;？PHP的echo $ USER_INFO [时代]＆GT;＆LT; / TD＆GT;
＆LT; / TR＆GT;
＆LT; /表＆gt;
＆LT; A HREF =HTTP：//本地主机：8888 / client.php行动= get_userlistALT =用户列表＆gt;返回到用户列表＆LT; / A＆GT;
＆LT; PHP
}
其他还有//把用户列表
{
$ USER_LIST =的file_get_contents（的http：//本地主机：8888 / api.php行动= get_user_list？'）;
$ USER_LIST = json_de code（$ USER_LIST，真正的）;
//这是非常快速和肮脏的!!!!!
？＆GT;
＆LT; UL＆GT;
？＆LT; PHP的foreach（$ USER_LIST为$用户）：＆GT;
＆LT;立GT;
＆LT; A HREF =＆LT; PHP回声的http：//本地主机：8888 / client.php行动= GET_USER和ID =？ $用户[ID]＆GT？; ALT =＆LT;？PHP的回声用户_。 $用户_ [ID]＆GT;＆GT;＆LT; PHP的echo $用户[名]＆GT;＆LT; / A＆GT;
＆LT; /李＆GT;
＆LT; PHP endforeach; ？＆GT;
＆LT; / UL＆GT;
＆LT; PHP
}？＆GT;
api.php
＆LT; PHP//这是API来显示可能的用户列表，并显示通过行动的特定用户。功能get_user_by_id（$ ID）
{
$ USER_INFO =阵列（）; //使数据库的调用。
开关（$编号）{
情况1：
$ USER_INFO =阵列（FIRST_NAME=＆gt;中马克，姓氏=＆gt;中西门，年龄= GT; 21）; //让我们说名字，姓氏，年龄
打破;
案例2：
$ USER_INFO =阵列（FIRST_NAME=＆gt;中弗雷德里克，姓氏=＆gt;中Zannetie，年龄= GT; 24）;
打破;
案例3：
$ USER_INFO =阵列（FIRST_NAME=＆gt;中劳拉，姓氏=＆gt;中Carbonnel，年龄= GT; 45）;
打破;
} 返回$ USER_INFO;
}功能get_user_list（）
{
$ USER_LIST =阵列（阵列（ID=＆GT; 1，名=＆gt;中西蒙），阵列（ID=＆GT; 2，名=＆gt;中Zannetie），阵列（编号=→3，姓名=＆gt;中Carbonnel））; //调用数据库，这里我提出3的用户列表。 返回$ USER_LIST;
}$ POSSIBLE_URL =阵列（get_user_list，GET_USER）;$值=发生错误;如果（使用isset（$ _ GET [行动]）及和放大器; in_array（$ _ GET [行动]，$ POSSIBLE_URL））
{
开关（$ _GET [行动]）
{
案get_user_list：
$值= get_user_list（）;
打破;
案GET_USER：
如果（使用isset（$ _ GET [ID]））
$值= get_user_by_id（$ _ GET [身份证]）;
其他
$值=失踪的说法;
打破;
}
}出口（json_en code（$值））;？＆GT;
我没有到数据库在这个例子中的任何呼叫，但通常这是你应该做的。你还应该以卷曲取代的file_get_contents功能。
The issue is this:
I have a web application that runs on a PHP server. I'd like to build a REST api for it.
I did some research and I figured out that REST api uses HTTP methods (GET, POST...) for certain URI's with an authentication key (not necessarily) and the information is presented back as a HTTP response with the info as XML or JSON (I'd rather JSON).
My question is:
- How do I, as the developer of the app, build those URI's? Do I need to write a PHP code at that URI?
- How do I build the JSON objects to return as a response?
Here is a very simply example in simple php.
There are 2 files client.php & api.php. I put both files on the same url : http://localhost:8888/, so you will have to change the link to your own url. (the file can be on two different servers).
This is just an example, it's very quick and dirty, plus it has been a long time since I've done php. But this is the idea of an api.
client.php
<?php
/*** this is the client ***/
if (isset($_GET["action"]) && isset($_GET["id"]) && $_GET["action"] == "get_user") // if the get parameter action is get_user and if the id is set, call the api to get the user information
{
$user_info = file_get_contents('http://localhost:8888/api.php?action=get_user&id=' . $_GET["id"]);
$user_info = json_decode($user_info, true);
// THAT IS VERY QUICK AND DIRTY !!!!!
?>
<table>
<tr>
<td>Name: </td><td> <?php echo $user_info["last_name"] ?></td>
</tr>
<tr>
<td>First Name: </td><td> <?php echo $user_info["first_name"] ?></td>
</tr>
<tr>
<td>Age: </td><td> <?php echo $user_info["age"] ?></td>
</tr>
</table>
<a href="http://localhost:8888/client.php?action=get_userlist" alt="user list">Return to the user list</a>
<?php
}
else // else take the user list
{
$user_list = file_get_contents('http://localhost:8888/api.php?action=get_user_list');
$user_list = json_decode($user_list, true);
// THAT IS VERY QUICK AND DIRTY !!!!!
?>
<ul>
<?php foreach ($user_list as $user): ?>
<li>
<a href=<?php echo "http://localhost:8888/client.php?action=get_user&id=" . $user["id"] ?> alt=<?php echo "user_" . $user_["id"] ?>><?php echo $user["name"] ?></a>
</li>
<?php endforeach; ?>
</ul>
<?php
}
?>
api.php
<?php
// This is the API to possibility show the user list, and show a specific user by action.
function get_user_by_id($id)
{
$user_info = array();
// make a call in db.
switch ($id){
case 1:
$user_info = array("first_name" => "Marc", "last_name" => "Simon", "age" => 21); // let's say first_name, last_name, age
break;
case 2:
$user_info = array("first_name" => "Frederic", "last_name" => "Zannetie", "age" => 24);
break;
case 3:
$user_info = array("first_name" => "Laure", "last_name" => "Carbonnel", "age" => 45);
break;
}
return $user_info;
}
function get_user_list()
{
$user_list = array(array("id" => 1, "name" => "Simon"), array("id" => 2, "name" => "Zannetie"), array("id" => 3, "name" => "Carbonnel")); // call in db, here I make a list of 3 users.
return $user_list;
}
$possible_url = array("get_user_list", "get_user");
$value = "An error has occurred";
if (isset($_GET["action"]) && in_array($_GET["action"], $possible_url))
{
switch ($_GET["action"])
{
case "get_user_list":
$value = get_user_list();
break;
case "get_user":
if (isset($_GET["id"]))
$value = get_user_by_id($_GET["id"]);
else
$value = "Missing argument";
break;
}
}
exit(json_encode($value));
?>
I didn't make any call to the database for this example, but normally that is what you should do. You should also replace the "file_get_contents" function by "curl".
这篇关于如何建立一个RESTful API？的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！
