本文深入探讨了 Yii2 应用在接收 application/json 类型 POST 请求时数据为空的问题，并提供了详细的解决方案。通过配置 yiiwebRequest::$parsers，Yii2 能够正确解析 JSON 请求体，确保后端能顺利获取前端发送的 JSON 数据。文章涵盖了前端 JavaScript 发送 JSON 的示例及后端 PHP 处理逻辑。
理解 JSON POST 请求与 Yii2 的默认行为
在 web 开发中，前端通常通过 post 请求向后端发送数据。常见的 content-type 有 application/x-www-form-urlencoded 和 multipart/form-data。web 服务器（如 apache, nginx）默认会将这两种类型的请求体解析，并将数据填充到 php 的 $_post 全局变量中。因此，yii2 框架默认也是从 $_post 中读取 post 参数。
然而，当前端使用 fetch 或 XMLHttpRequest 发送 Content-Type: application/json 类型的请求时，请求体中的 JSON 数据不会被 Web 服务器自动解析并填充到 $_POST 变量中。这意味着，即使请求成功发送到后端，Yii2 尝试通过 Yii::$app->request->post(‘paramName’) 获取参数时，也会因为 $_POST 为空而得到 null 值。
解决方案：配置 Yii2 请求解析器
为了让 Yii2 能够正确解析 application/json 类型的请求体，你需要将 JSON 解析器添加到 yiiwebRequest::$parsers 属性中。这通常在你的应用程序配置文件（例如 config/web.php 或 config/main.php）中完成。
在 components 数组中找到 request 组件的配置，并添加 parsers 属性：
// config/web.php 或 config/main.php'components' => [ 'request' => [ // !!! insert a secret key in the following (if it is empty) - this is required by cookie validation 'cookieValidationKey' => 'your-secret-key', // 请替换为你的密钥 'parsers' => [ 'application/json' => 'yiiwebJsonParser', ], // ... 其他请求组件配置 ], // ... 其他组件配置]
通过上述配置，当 Yii2 接收到 Content-Type 为 application/json 的请求时，它会自动使用 yiiwebJsonParser 来解析请求体，并将解析后的数据填充到 Yii::$app->request->post() 方法可访问的内部数据结构中。
前端 JavaScript 发送 JSON 请求示例
前端使用 fetch API 发送 JSON 数据的示例代码如下。请注意 headers 中 Content-Type: application/json 的设置，以及 body 中使用 JSON.stringify() 将 JavaScript 对象转换为 JSON 字符串。
let csrfToken = document.querySelector("meta[name='csrf-token']").content;let csrfParam = document.querySelector("meta[name='csrf-param']").content;// 假设 e.id 和 this.state.ChangeName 是需要发送的数据const dataToSend = { 'id': e.id, 'name': this.state.ChangeName};fetch("http://site.se/react/save-babysitter", { method: "POST", headers: { "Content-Type": "application/json", // 关键：指定内容类型为 JSON "Accept": "application/json", // Yii2 CSRF 令牌，确保请求安全 [csrfParam]: csrfToken, // 使用中括号语法，因为 csrfParam 是变量 "X-CSRF-Token": csrfToken // 兼容性考虑，通常 Yii2 会检查其中一个 }, body: JSON.stringify(dataToSend) // 将 JavaScript 对象转换为 JSON 字符串}).then(response => { // 检查响应状态码，如果不是 2xx，则抛出错误 if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } return response.json(); // 解析 JSON 响应}).then((data) => { console.log("Success:", data);}).catch((error) => { console.error("Error:", error);});
注意事项：
CSRF 令牌： 在发送 POST 请求时，为了防止跨站请求伪造 (CSRF) 攻击，Yii2 默认会检查 CSRF 令牌。前端需要从页面中获取 CSRF 令牌并将其作为请求头或请求体参数发送。上述代码示例中，令牌通过 csrf-param 和 X-CSRF-Token 头部发送。错误处理： 在 fetch 的 then 链中添加 response.ok 检查和 catch 块，可以更好地处理网络错误和服务器响应错误。
后端 PHP 控制器处理逻辑
在配置了 JsonParser 之后，Yii2 的 request 组件就能够正确解析 JSON 请求体了。你现在可以通过 Yii::$app->request->post() 方法像获取普通表单数据一样获取 JSON 数据中的参数。
request; // 设置响应格式为 JSON Yii::$app->response->format = Response::FORMAT_JSON; // 获取解析后的 JSON 数据 // 如果前端发送的是 {"id": 123, "name": "Test"} $id = $request->post('id'); $name = $request->post('name'); // 也可以获取所有 POST 参数为一个数组 // $postData = $request->post(); // 生产环境中，通常需要对接收到的数据进行验证和处理 if (empty($id) || empty($name)) { return [ 'status' => 'error', 'message' => 'ID 或 Name 不能为空。', ]; } // 假设这里进行数据保存或其他业务逻辑 // 例如：$model = new Babysitter(['id' => $id, 'name' => $name]); $model->save(); // 返回成功响应 return [ 'status' => 'success', 'message' => '数据接收成功！', 'received_id' => $id, 'received_name' => $name, // 可以在这里返回更多处理结果 ]; }}
重要提示：
CSRF 验证： 如果你的控制器或单个 action 开启了 CSRF 验证（Yii2 默认开启），请确保前端正确发送了 CSRF 令牌。如果前端无法发送令牌或你确定不需要 CSRF 保护（例如，对于仅供内部 API 调用的接口），你可以在控制器中设置 $enableCsrfValidation = false; 或在 action 中通过行为配置禁用。但请务必了解禁用 CSRF 验证可能带来的安全风险。getRawBody()： 如果你需要获取原始的 JSON 字符串而不是解析后的数据，可以使用 Yii::$app->request->getRawBody() 方法。这在某些需要手动解析或记录原始请求体的场景中非常有用。响应格式： 在 Yii2 中，为了返回 JSON 格式的响应，建议设置 Yii::$app->response->format = yiiwebResponse::FORMAT_JSON;，然后直接返回一个 PHP 数组或对象，Yii2 会自动将其编码为 JSON 字符串。
总结
通过在 Yii2 应用程序的 request 组件中配置 yiiwebJsonParser，我们可以轻松地解决后端无法接收 application/json 类型 POST 请求数据的问题。这一配置使得 Yii2 能够无缝地处理前端发送的 JSON 数据，极大地简化了前后端数据交互的复杂性。在实际开发中，除了正确配置解析器，还应注意 CSRF 保护、数据验证和规范的错误处理，以构建健壮和安全的 Web 应用程序。
以上就是Yii2 中处理 JSON POST 请求：配置与实践的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1289876.html
微信扫一扫 
支付宝扫一扫 
