搭配 AJAX 调用设置 JSON 响应头

M66 2025-05-18

怎么用 header 函数设置 JSON 响应头，配合 AJAX 调用返回数据？

在 Web 开发中，常常需要处理与前端的异步请求数据交互，尤其是在使用 AJAX 调用时返回数据时。为了确保浏览器能够正确处理返回的数据格式，我们需要设置正确的响应头信息。如果我们希望返回的数据是 JSON 格式，PHP 提供了 header() 函数来设置 HTTP 响应头。本文将介绍如何使用 header() 函数设置 JSON 响应头，并与 AJAX 一起返回 JSON 数据。

设置 JSON 响应头

要向客户端返回 JSON 格式的数据，首先要确保 HTTP 响应头中正确地设置了 Content-Type 为 application/json。这样浏览器就会知道它将收到的是 JSON 格式的数据，而不是 HTML 或其它格式。

<?php
// 设置响应头，指定返回数据类型为 JSON
header('Content-Type: application/json');

// 创建一个关联数组，表示要返回的数据
$response = array(
    'status' => 'success',
    'message' => 'Data has been successfully processed.'
);

// 使用 json_encode() 函数将数组转换为 JSON 格式
echo json_encode($response);
?>

结合 AJAX 调用

当设置了正确的 JSON 响应头后，接下来可以通过 AJAX 调用来获取返回的 JSON 数据。假设前端使用 JavaScript 的 fetch() 函数或 jQuery 的 $.ajax() 来发送请求并接收数据。以下是使用 fetch() 发送请求并处理 JSON 响应的示例：

使用 fetch() 发送 AJAX 请求

fetch('http://m66.net/api/data.php', {
    method: 'GET'
})
.then(response => response.json()) // 解析 JSON 数据
.then(data => {
    console.log(data);  // 在控制台输出返回的数据
})
.catch(error => console.error('Error:', error));

使用 jQuery 的 $.ajax() 发送请求

$.ajax({
    url: 'http://m66.net/api/data.php',
    type: 'GET',
    dataType: 'json',  // 指定返回的数据类型为 JSON
    success: function(data) {
        console.log(data);  // 在控制台输出返回的数据
    },
    error: function(xhr, status, error) {
        console.error('Error:', error);
    }
});

完整示例

下面是一个完整的 PHP 和 AJAX 示例，展示如何使用 header() 函数设置 JSON 响应头并在前端通过 AJAX 获取数据：

PHP (data.php)

<?php
// 设置响应头，指定返回数据类型为 JSON
header('Content-Type: application/json');

// 创建一个关联数组，表示要返回的数据
$response = array(
    'status' => 'success',
    'message' => 'Data has been successfully processed.',
    'data' => array('item1', 'item2', 'item3')
);

// 使用 json_encode() 函数将数组转换为 JSON 格式
echo json_encode($response);
?>

JavaScript (前端)

fetch('http://m66.net/api/data.php', {
    method: 'GET'
})
.then(response => response.json()) // 解析 JSON 数据
.then(data => {
    console.log(data);  // 在控制台输出返回的数据
})
.catch(error => console.error('Error:', error));

注意事项

确保 JSON 格式正确：在 PHP 中返回的数据应该是有效的 JSON 格式。你可以使用 json_encode() 函数将 PHP 数组转换为 JSON 格式的字符串。
CORS 问题：如果前端和后端不在同一个域名下，可能会遇到跨域资源共享（CORS）的问题。你需要在 PHP 中设置 Access-Control-Allow-Origin 响应头来允许跨域请求：
```
header('Access-Control-Allow-Origin: *');
```
这将允许任何域名的请求访问你的 API。
错误处理：在处理 JSON 响应时，确保前端能够正确处理返回的错误信息，比如 HTTP 状态码不为 200 的情况。

通过设置正确的响应头和使用 AJAX，我们可以在前后端之间高效地传递 JSON 数据。