如何用 header() 模拟 RESTful API 响应头

在开发 Web 应用程序时，RESTful API 已成为一种广泛使用的架构风格，它遵循标准的 HTTP 协议来提供灵活、可扩展的接口。通过正确使用 HTTP 响应头，开发者能够控制接口的行为和响应内容，增强接口的交互性和安全性。

PHP 提供了 header() 函数来设置响应头，允许开发者灵活地管理 API 的响应内容、状态码、缓存控制等。本文将介绍如何使用 header() 函数模拟 RESTful API 的响应头，以实现更灵活的接口交互。

1. 使用 PHP 的 header() 函数设置基础响应头

在 PHP 中，header() 函数可以用来发送原始 HTTP 头部信息。其基本语法如下：

header('Header-Name: Header-Value');

例如，要返回一个标准的 Content-Type 头部信息，可以这样设置：

header('Content-Type: application/json');

在模拟 RESTful API 响应时，通常需要返回 JSON 格式的数据以及相应的 HTTP 状态码。因此，可以设置如下响应头：

header('Content-Type: application/json');
header('HTTP/1.1 200 OK');

2. 模拟 RESTful API 响应头的常见类型

2.1 返回 JSON 格式的数据

在 RESTful API 中，响应数据通常是 JSON 格式。为了告知客户端返回的数据类型，可以设置 Content-Type 头部：

header('Content-Type: application/json');

如果要返回一个 JSON 格式的响应数据，通常可以使用以下代码：

$data = ['message' => '成功', 'code' => 200];
echo json_encode($data);

2.2 设置响应状态码

RESTful API 的响应状态码是至关重要的，它指示了请求的处理结果。例如，200 OK 表示请求成功，404 Not Found 表示请求的资源不存在，500 Internal Server Error 表示服务器出现错误。

使用 header() 函数可以设置响应状态码：

header('HTTP/1.1 404 Not Found');

如果需要模拟其他常见状态码，可以根据情况进行设置：

header('HTTP/1.1 201 Created');

2.3 设置缓存控制

在某些情况下，API 的响应需要设置缓存头，以控制客户端或代理缓存响应。常见的缓存控制头部包括 Cache-Control 和 Expires：

header('Cache-Control: no-cache, no-store, must-revalidate');
header('Expires: 0');

这些头部会告知客户端不要缓存响应数据，并且每次都重新请求数据。

2.4 设置 CORS（跨域资源共享）响应头

如果您的 API 需要被不同域名的客户端调用，那么必须配置跨域资源共享（CORS）响应头。可以使用 Access-Control-Allow-Origin 头来允许指定的域名访问 API：

header('Access-Control-Allow-Origin: https://m66.net');

如果希望允许任何域名访问 API，可以使用通配符 *：

header('Access-Control-Allow-Origin: *');

2.5 定义自定义响应头

RESTful API 还可以根据需要设置自定义的响应头。通过 header() 函数，你可以发送任何自定义的头部信息：

header('X-Request-Id: 12345');
header('X-Rate-Limit-Limit: 100');

这些自定义头部可以用来提供额外的信息，比如请求的 ID、速率限制等。

3. 完整示例：模拟 RESTful API 的响应

以下是一个完整的 PHP 示例，演示了如何使用 header() 函数模拟一个简单的 RESTful API 响应：