超文本传输​​协议 (http) 是网络的生命。每次传输文档或发出 ajax 请求时都会使用它。但令人惊讶的是，http 在一些 web 开发人员中相对陌生。

本介绍将演示 REST 设计原则集如何支撑 HTTP。您将学习如何通过构建几乎可以在任何设备或操作系统上使用的界面来发挥其全部功能。

Envato Market 还拥有数千个有用的代码脚本、插件和应用程序来帮助您进行 Web 开发，例如 Premium URL Shortener，这是一个 PHP 脚本，您可以将其安装在服务器上以创建自定义缩短的 URL。

为什么要休息？

REST 是一种组织独立系统之间交互的简单方法。自 2005 年以来，它越来越受欢迎，并激发了 Twitter API 等服务的设计。这是因为 REST 允许您以最小的开销与手机和其他网站等各种客户端进行交互。理论上，REST 并不依赖于 Web，但它几乎总是这样实现，并且受到 HTTP 的启发。因此，REST 可以用在任何可以使用 HTTP 的地方。

另一种选择是在 HTTP 之上构建相对复杂的约定。通常，这会表现为全新的语言。最杰出的例子是 SOAP 和 GraphQL。您必须学习一套全新的约定，但您永远不会充分利用 HTTP。由于 REST 受到 HTTP 的启发并发挥了其优势，因此它是了解 HTTP 工作原理的最佳方式。

初步概述后，我们将检查每个 HTTP 构建块：URL、HTTP 动词和响应代码。我们还将回顾如何以 RESTful 方式使用它们。在此过程中，我们将通过示例应用程序来说明该理论，该应用程序模拟通过 Web 界面跟踪与公司客户相关的数据的过程。

HTTP

HTTP 是允许在网络上来回发送文档的协议。协议是一组规则，用于确定可以交换哪些消息以及哪些消息是对其他消息的适当回复。另一个常见的协议是 POP3，您可以使用它来获取硬盘上的电子邮件。

在HTTP中，有两种不同的角色：服务器和客户端。一般来说，谈话总是由客户发起；服务器回复。 HTTP 是基于文本的；也就是说，消息本质上是文本位，尽管消息正文也可以包含其他媒体。使用文本可以轻松监控 HTTP 交换。

HTTP 消息由标头和正文组成。身体常常是空的；它包含您想要通过网络传输的数据，以便根据标头中的说明使用它。 header包含元数据，例如编码信息；但是，对于请求，它还包含重要的 HTTP 方法。在 REST 风格中，您会发现标头数据通常比正文更重要。

在工作中监视 HTTP

如果您使用 Chrome 或 Firefox 开发者工具，请点击顶部栏上的网络以查看您当前所在网站中的 HTTP 请求。您可能需要在打开的网络开发人员工具的情况下刷新页面才能查看日志。例如：

熟悉 HTTP 的另一个有用方法是使用专用客户端，例如 cURL。 cURL 是一个命令行工具，可在所有主要操作系统上使用。

安装 cURL 后，输入：

curl -v google.com

这将显示完整的 HTTP 对话。请求前面是 >，而响应前面是 <。

网址

URL 是您识别要操作的内容的方式。我们说每个 URL 标识一个资源。这些 URL 与分配给网页的 URL 完全相同。事实上，网页是一种资源。

让我们举一个更奇特的例子，考虑我们的示例应用程序，它管理公司的客户列表。 /clients 将识别所有客户端，而 /clients/jim 将识别名为“Jim”的客户端，假设他是唯一具有该名称的客户端。

在这些示例中，我们通常不会在 URL 中包含主机名，因为从界面组织方式的角度来看，它无关紧要。尽管如此，主机名对于确保资源标识符在整个网络上是唯一的很重要。我们经常说您将资源请求发送到主机。主机与资源路径分开包含在标头中，资源路径位于请求标头的正上方：

GET /clients/jim HTTP/1.1

Host: example.com

资源最好被视为名词。例如，以下内容不是 RESTful：

/clients/add

这是因为它使用 URL 来描述操作。这是区分 RESTful 和非 RESTful 系统的一个相当基本的点。

最后，URL 应根据需要尽可能精确；唯一标识资源所需的所有内容都应包含在 URL 中。您不需要在请求中包含标识资源的数据。这样，URL 就可以充当应用程序处理的所有数据的完整映射。

但是如何指定操作呢？例如，您怎么说您希望创建而不是检索新的客户记录？这就是 HTTP 动词发挥作用的地方。

HTTP 动词

每个请求在请求标头中指定特定的 HTTP 动词或方法。这是请求标头中的第一个全大写单词。例如，GET / HTTP/1.1 表示正在使用 GET 方法，而 DELETE /clients/anne HTTP/1.1 表示正在使用 DELETE 方法。

HTTP 动词告诉服务器如何处理 URL 标识的数据。请求可以选择在其正文中包含执行操作可能需要的其他信息，例如您想要与资源一起存储的数据。您可以使用 -d 选项在 cURL 中提供此数据。

如果您曾经创建过 HTML 表单，您就会熟悉两个最重要的 HTTP 动词：GET 和 POST。但可用的 HTTP 动词要多得多。构建 RESTful API 最重要的是 GET、POST、PUT 和 DELETE。还有其他方法，例如 HEAD 和 OPTIONS，但比较少见。如果您想了解所有其他 HTTP 方法，官方来源是 IETF。

获取

GET 是最简单的 HTTP 请求方法，浏览器每次单击链接或在地址栏中输入 URL 时都会使用该方法。它指示服务器将 URL 标识的数据传输到客户端。切勿因 GET 请求而在服务器端修改数据。从这个意义上说，GET 请求是只读的，但是当然，一旦客户端收到数据，它就可以自由地在自己这边对其进行任何操作 - 例如，将其格式化以供显示。

放置

当您希望创建或更新由 URL 标识的资源时，将使用 PUT 请求。例如， PUT /clients/robin 可能会在服务器上创建一个名为 Robin 的客户端。您会注意到 REST 完全与后端无关；请求中没有任何内容告诉服务器应该如何创建数据——只是告诉服务器应该如何创建数据。这使您可以在需要时轻松更换后端技术。 PUT 请求包含在主体中更新或创建资源时使用的数据。在 cURL 中，您可以使用 -d 开关将数据添加到请求：

curl -v -X PUT -d "some text"

删除

DELETE 应该执行与 PUT 相反的操作；当您想要删除由请求的 URL 标识的资源时，应该使用它。

curl -v -X DELETE /clients/anne

这将删除与该资源关联的所有数据，由 /clients/anne 标识。

发布

POST 当您希望在服务器上进行的处理应该重复时使用，如果 POST 请求被重复（也就是说，它们不是幂等；更多内容请参见下文） ）。此外，POST 请求应导致将请求正文作为您要发布到的 URL 的下属进行处理。

简单来说，POST /clients/ 不应导致 /clients/ 本身的资源被修改，而是 URL 以 /clients/ 开头的资源被修改。例如，它可以将一个新客户端附加到列表中，并使用服务器生成的 id：

/clients/some-unique-id

PUT 请求很容易使用，而不是 POST 请求，反之亦然。有些系统仅使用一个，有些系统使用 POST 进行创建操作，使用 PUT 进行更新操作（因为 PUT 要求您始终提供完整的 URL），有些系统甚至使用 POST 进行更新，并使用 PUT用于创建。

通常，POST 请求用于触发服务器上不符合 Create/Update/Delete 范例的操作，但这超出了 REST 的范围。在我们的示例中，我们将始终使用 PUT。

HTTP 方法分类

安全和不安全的方法

安全方法是那些从不修改资源的方法。从上面列出的四种方法中，唯一安全的方法是 GET。其他的不安全，因为它们可能会导致资源的修改。

幂等方法

无论重复请求多少次，这些方法都会获得相同的结果：它们是 GET、PUT 和 DELETE。唯一的非幂等方法是 POST。

PUT 和 DELETE 被认为是幂等的可能会令人惊讶，但这很容易解释。使用相同的主体重复 PUT 方法应该以与上一个 PUT 请求中描述的方式相同的方式修改资源：不会有任何改变！同样，删除一个资源两次也是没有意义的。因此，无论重复 PUT 或 DELETE 请求多少次，结果都应该与只执行一次相同。

记住：最终决定使用某种 HTTP 方法时会发生什么情况的是程序员。 HTTP 实现中没有任何固有的东西会自动导致资源被创建、列出、删除或更新。您必须小心地正确应用 HTTP 协议并自行强制执行这些语义。

表示

我们可以通过以下方式总结到目前为止所学到的知识：HTTP 客户端和 HTTP 服务器交换有关由 URL 标识的资源的信息。

我们说请求和响应包含资源的表示。通过表示，我们指的是某种格式的有关资源状态或该状态未来应如何的信息。标头和正文都是表示的一部分。

包含元数据的 HTTP 标头由 HTTP 规范严格定义；它们只能包含纯文本，并且必须以某种方式格式化。

正文可以包含任何格式的数据，这就是 HTTP 真正发挥作用的地方。您知道可以用任何人类语言发送纯文本、图片、HTML 和 XML。通过请求元数据或不同的 URL，您可以选择同一资源的不同表示形式。例如，您可以将网页发送到浏览器，并将 JSON 发送到应用程序。

HTTP 响应应指定正文的内容类型。这是在标头的 Content-Type 字段中完成的。例如：

Content-Type: application/json

为简单起见，我们的示例应用程序仅来回发送 JSON，但应用程序的设计方式应使您可以轻松更改数据格式，以适应不同的客户端或用户偏好。

HTTP 客户端库

要尝试不同的请求方法，您需要一个客户端，它允许您指定要使用的方法。不幸的是，HTML 表单不符合要求，因为它们只允许您发出 GET 和 POST 请求。在现实生活中，API 是通过单独的客户端应用程序或通过浏览器中的 JavaScript 以编程方式访问的。

这就是为什么除了服务器之外，在您选择的编程语言中拥有良好的 HTTP 客户端功能也很重要。

一个非常流行的 HTTP 客户端库是 cURL。您已经在本教程前面熟悉了 cURL 命令。 cURL 包括一个独立的命令行程序和一个可供各种编程语言使用的库。特别是，cURL 通常是 PHP 开发人员选择的 HTTP 客户端解决方案。其他语言（例如 Python）提供更多本机 HTTP 客户端库。

设置示例应用程序

现在我们将构建一个准系统示例应用程序。您可以按照相应部分并使用代码附件中的相应文件夹，在 Node.js 或 PHP 中构建示例应用程序。两个应用程序的工作方式相同。如果您不确定选择哪个，Node.js 可能是更好的选择，因为它现在更常用。

Node.js 和 Express

为了运行示例应用程序，您需要安装 Node.js。完成后，打开源代码附件中的 node.js 目录并运行 npm install。

PHP

要运行示例应用程序，您需要安装 PHP 5 和具有某种运行 PHP 机制的 Web 服务器。当前版本必须至少为 5.2 版本才能访问 json_encode() 和 json_decode() 函数。

对于服务器，最常见的选择仍然是 Apache 和 mod_php，但您可以自由地使用您喜欢的任何替代方案。有一个 Apache 配置示例，其中包含重写规则，可帮助您快速设置应用程序。对任何以 /clients/ 开头的 URL 的所有请求都必须路由到我们的 server.php 文件。

在 Apache 中，您需要启用 mod_rewrite 并将提供的 mod_rewrite 配置放在您的 Apache 配置或 .htacess 中的某个位置文件。这样，server.php 将响应来自服务器的所有请求。必须使用 Nginx 或您决定使用的任何替代服务器来实现同样的效果。

示例应用程序如何工作

Node.js 和 Express

如果你查看代码，你会看到一些不同的方法，例如 app.get 或 app.put。这些是不同的路线。每个路由都匹配特定的 URL 和 HTTP 方法。

app.get("/clients", (_, res) => {
    ...
});
app.get("/clients/:client", (req, res) => {
	...
});
app.put("/clients/:client", (req, res) => {
	...
});
app.delete("/clients/:client", (req, res) => {
	...
});

您可能已经注意到 URL 中的 :client 。这是一个参数，这意味着 URL 该部分中的任何内容都将与该路由匹配，并且 URL 该部分将作为参数传递。在路由处理函数内部，您可以看到描述逻辑的注释。最后是app.listen。

app.listen(port, () => {
    console.log(`Example app listening on port ${port}`);
});

这将在 port 指定的端口启动服务器。回调函数在服务器启动后执行。

PHP

以 REST 方式处理请求有两个关键。第一个关键是根据 HTTP 方法启动不同的处理 - 即使 URL 相同。在 PHP 中，$_SERVER 全局数组中有一个变量，用于确定使用哪种方法发出请求：

$_SERVER['REQUEST_METHOD']

$_SERVER['REQUEST_URI']

$resource = array_shift($paths);

if ($resource == 'clients') {
    $name = array_shift($paths);

    if (empty($name)) {
        $this->handle_base($method);
    } else {
        $this->handle_name($method, $name);
    }

} else {
    // We only handle resources under 'clients'
    header('HTTP/1.1 404 Not Found');
}

switch($method) {
  case 'PUT':
      $this->create_contact($name);
      break;

  case 'DELETE':
      $this->delete_contact($name);
      break;

  case 'GET':
      $this->display_contact($name);
      break;

  default:
      header('HTTP/1.1 405 Method Not Allowed');
      header('Allow: GET, PUT, DELETE');
      break;
  }

curl -v http://localhost:80/clients/jim

curl -v http://localhost:80/clients/

curl -v -X "PUT" http://localhost:80/clients/paul -d '{"address":"Sunset Boulevard" }' -H 'content-type: application/json'

curl -v -X "DELETE" http://localhost:80/clients/anne

curl -v http://localhost:80/clients/jerry

curl -v -X "PUT" http://localhost:80/clients/anne