0

0

PHP中处理fetch API请求:JSON负载与URL编码数据的实践指南

聖光之護

聖光之護

发布时间:2025-09-12 13:29:42

|

755人浏览过

|

来源于php中文网

原创

php中处理fetch api请求:json负载与url编码数据的实践指南

本教程详细探讨了PHP服务器端如何有效接收并处理JavaScript fetch API发送的数据。我们将深入讲解使用 file_get_contents("php://input") 解析JSON负载的方法及其并发安全性,并介绍如何通过设置 Content-type 为 application/x-www-form-urlencoded 来利用 $_POST 接收数据。同时,文章还将讨论 X-Requested-With 请求头的应用与局限性,提供两种方法的示例代码,并强调了数据处理中的安全注意事项。

1. 使用 file_get_contents("php://input") 处理 JSON 负载

前端使用 fetch API 以 JSON 格式发送数据时,通常会将数据通过 JSON.stringify() 序列化后放入请求体(body)中,并设置 Content-Type 为 application/json。在这种情况下,PHP 无法通过 $_POST 超全局变量直接访问这些数据,因为 $_POST 主要用于解析 application/x-www-form-urlencoded 或 multipart/form-data 类型的数据。

为了获取原始的 JSON 请求体,PHP 提供了一个特殊的输入流 php://input。通过读取这个流,我们可以获取到完整的请求体内容,然后使用 json_decode() 函数将其解析成 PHP 数组或对象。

前端 JavaScript 代码示例 (发送 JSON):

const data = { par1: 'value1', par2: 'value2' };

fetch('/myscript.php', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json' // 明确声明发送的是 JSON
    },
    mode: 'same-origin', // 确保同源策略
    credentials: 'same-origin', // 发送 Cookies 等凭证
    body: JSON.stringify(data) // 将数据序列化为 JSON 字符串
})
.then(response => response.text())
.then(output => {
    console.log(output); // 处理服务器响应
})
.catch(error => {
    console.error('Fetch error:', error);
});

后端 PHP 代码示例 (接收 JSON):

立即学习PHP免费学习笔记(深入)”;

 'Invalid JSON data']);
    exit;
}

// 访问数据
$param1 = $inputData['par1'] ?? null;
$param2 = $inputData['par2'] ?? null;

// 进行业务逻辑处理...
$output = "Received: par1 = {$param1}, par2 = {$param2}";

// 返回响应
header('Content-Type: text/plain'); // 根据实际响应类型设置
echo $output;
?>

关于 php://input 的并发安全性:

许多开发者可能会担心,如果多个 fetch 请求同时访问 php://input,是否会导致数据冲突。实际上,这种担忧是没有必要的。PHP 服务器在处理每个 HTTP 请求时,都会为该请求创建一个独立的执行环境。这意味着,每一次对 myscript.php 的调用,都会启动一个新的 PHP 脚本实例,该实例拥有自己独立的 php://input 流。因此,不同的并发请求之间不会相互干扰,数据是隔离且安全的。

2. 请求来源验证与 X-Requested-With 头部

在 jQuery 的 $.post() 等 AJAX 方法中,通常会自动添加 X-Requested-With: XMLHttpRequest 头部。这在过去常被用于在服务器端判断请求是否来源于 AJAX。然而,原生 fetch API 默认不会添加此头部。

手动添加 X-Requested-With 头部:

如果您的后端逻辑依赖于此头部进行判断,您可以手动在 fetch 请求中添加它:

前端 JavaScript 代码示例 (添加 X-Requested-With):

如此AI员工
如此AI员工

国内首个全链路营销获客AI Agent

下载
const data = { par1: 'value1', par2: 'value2' };

fetch('/myscript.php', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
        'X-Requested-With': 'XMLHttpRequest' // 手动添加此头部
    },
    mode: 'same-origin',
    credentials: 'same-origin',
    body: JSON.stringify(data)
})
.then(response => response.text())
.then(output => {
    console.log(output);
})
.catch(error => {
    console.error('Fetch error:', error);
});

后端 PHP 代码示例 (检查 X-Requested-With):

重要安全提示:

X-Requested-With 头部不应被视为一种可靠的安全机制来防止“黑客攻击”或验证请求来源。恶意用户可以轻易地伪造任何 HTTP 头部,包括 X-Requested-With。真正的安全防护应该依赖于更强大的机制,例如:

  • 身份验证 (Authentication):确保请求来自已登录且授权的用户。
  • 授权 (Authorization):验证用户是否有权执行特定操作。
  • CSRF (Cross-Site Request Forgery) 令牌:防止跨站请求伪造攻击,确保请求是由用户自愿发起的。
  • CORS (Cross-Origin Resource Sharing):控制哪些域可以访问您的资源。

3. 使用 URL 编码数据与 $_POST 的替代方案

如果您觉得 file_get_contents("php://input") 结合 json_decode() 看起来比较“非主流”,或者您的数据结构更适合传统的表单提交方式,您可以选择以 application/x-www-form-urlencoded 格式发送数据。在这种情况下,PHP 会自动将数据解析到 $_POST 超全局变量中,就像处理普通 HTML 表单提交一样。

前端 JavaScript 代码示例 (发送 URL 编码数据):

const par1 = 'value1 with spaces';
const par2 = 'value2&symbols';

// 构建 URL 编码字符串
const body = `par1=${encodeURIComponent(par1)}&par2=${encodeURIComponent(par2)}`;

fetch('/myscript.php', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/x-www-form-urlencoded', // 明确声明发送的是 URL 编码数据
        'X-Requested-With': 'XMLHttpRequest' // 如果需要,可以继续添加
    },
    mode: 'same-origin',
    credentials: 'same-origin',
    body: body // 发送 URL 编码字符串
})
.then(response => response.text())
.then(output => {
    console.log(output);
})
.catch(error => {
    console.error('Fetch error:', error);
});

后端 PHP 代码示例 (接收 URL 编码数据):

 'No POST data received']);
    exit;
}

// 进行业务逻辑处理...
$output = "Received via _POST: par1 = {$param1}, par2 = {$param2}";

// 返回响应
header('Content-Type: text/plain');
echo $output;
?>

选择哪种方式?

  • JSON 负载 (php://input):适用于发送复杂、嵌套的数据结构,是现代 RESTful API 的首选。它使得前后端数据格式保持一致,易于处理。
  • URL 编码 ($_POST):适用于发送扁平、简单的键值对数据,与传统表单提交兼容。如果您的数据非常简单,或者您希望利用 PHP 自动解析到 $_POST 的便利性,这是一种简单直接的方法。

总结

fetch API 是现代 Web 开发中进行异步请求的强大工具。在 PHP 后端处理 fetch 请求时,您可以根据数据传输的格式选择合适的方法:对于 JSON 格式的数据,使用 file_get_contents("php://input") 并结合 json_decode() 是标准且推荐的做法;对于传统的 URL 编码数据,PHP 会自动将其解析到 $_POST 数组中。

无论选择哪种方法,都应牢记安全是首要考虑因素。避免依赖易于伪造的 HTTP 头部进行安全验证,而应实施全面的身份验证、授权和 CSRF 保护机制,以确保应用程序的健壮性和安全性。理解这些机制将帮助您构建更安全、更高效的 Web 应用程序。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2749

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1676

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1536

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

1015

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1464

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1235

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1569

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1307

2023.11.13

Golang 性能分析与pprof调优实战
Golang 性能分析与pprof调优实战

本专题系统讲解 Golang 应用的性能分析与调优方法,重点覆盖 pprof 的使用方式,包括 CPU、内存、阻塞与 goroutine 分析,火焰图解读,常见性能瓶颈定位思路,以及在真实项目中进行针对性优化的实践技巧。通过案例讲解,帮助开发者掌握 用数据驱动的方式持续提升 Go 程序性能与稳定性。

0

2026.01.22

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 9.1万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 9.6万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号