php 8.6处理json请求时,应把媒体类型、字节限制、json语法和业务字段分别验证。8.6的json错误消息增加了位置信息,但客户端通常只需要稳定的简短错误;原始请求和完整异常不能无差别返回或写入公共日志。

PHP官方文档中的JSON请求相关说明。 图源:PHP Documentation Group(CC BY3.0)。
给请求体设置明确的协议
<?php
function respond(int $status, array $data): never {
http_response_code($status);
header('Content-Type: application/json; charset=utf-8');
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);
exit;
}
$type = strtolower(trim(explode(';', $_SERVER['CONTENT_TYPE'] ?? '')[0]));
if ($type !== 'application/json') { respond(415, ['error' => '需要JSON请求']); }
$body = file_get_contents('php://input', false, null, 0, 65537);
if ($body === false) { respond(500, ['error' => '读取失败']); }
if (strlen($body) > 65536) { respond(413, ['error' => '请求过大']); }
try { $data = json_decode($body, true, 64, JSON_THROW_ON_ERROR); }
catch (JsonException $e) {
error_log('JSON decode failed code=' . $e->getCode());
respond(400, ['error' => 'JSON语法错误']);
}
if (!is_array($data) || count($data) !== 2
|| array_diff(array_keys($data), ['name', 'enabled']) !== []
|| !isset($data['name'], $data['enabled'])
|| !is_string($data['name']) || strlen($data['name']) > 200
|| !is_bool($data['enabled'])) {
respond(422, ['error' => '字段不符合约定']);
}
respond(200, ['name' => $data['name'], 'enabled' => $data['enabled']]);分别测试状态码与数据类型
用正确的name字符串和enabled布尔值验证200,再检查错误Content-Type、超过64KiB、损坏JSON及字符串形式的true。最后一种应返回422,不应通过宽松转换变成真。示例只回显受控字段,不执行持久化业务。
大小限制不能只信Content-Length
请求头可能不存在或不可信,所以示例实际最多读取上限加一个字节。Web服务器和反向代理也应设置相应请求体上限。JSON语法合法仍可能出现重复键或更复杂协议问题,需要按接口契约追加相应校验。
KeystoneJS 是一个功能强大的开源无头 CMS,适用于 Node.js,它根据您的模式定义自动生成 GraphQL API 和基于 React 的管理界面。由 Thinkmill 构建,支持 PostgreSQL 和 SQLite、自定义访问控制、钩子、虚拟字段和基于文档的富文本编辑。

PHP官方文档中的JSON请求相关说明。 图源:PHP Documentation Group(CC BY3.0)。
日志中的错误位置仅在确有排障需要且有隐私控制时使用,不把含输入片段的异常消息统一回传。对正式写接口,还应独立完成认证、授权、幂等与并发控制,不能把JSON验证器当成完整API安全方案。


















