Phalcon 5 中 POST 请求无法获取 JSON 数据的原因与解决方案

当你通过 Fetch API 发送如下 json 请求时：

fetch('/api/user', {   method: 'POST',   headers: {     'Content-Type': 'application/json'   },   body: JSON.stringify({     email: 'user@example.com',     password: 'secret123'   }) });

PHP 不会将 JSON 解析并填入 $_POST，因此 $this->request->getPost(’email’) 返回 NULL，$_POST 也为空数组。这是预期行为，与 Phalcon 无关，而是 PHP 底层限制。

✅ 正确做法是使用 Phalcon 提供的专用方法解析 JSON：

// 在控制器 action 中 $jsonData = $this->request->getJsonRawBody(true); // true → 返回关联数组（而非 stdClass）  if ($jsonData === null) {     throw new Exception('Invalid JSON in request body'); }  $data = [     'email'    => filter_var($jsonData->email ?? '', FILTER_VALIDATE_EMAIL),     'password' => filter_var($jsonData->password ?? '', FILTER_SANITIZE_STRING), ];

? 注意：getJsonRawBody(true) 的第二个参数设为 true 可直接返回 Array（默认为 stdClass 对象），便于后续处理；若原始 JSON 格式错误，该方法返回 null，建议显式校验。

⚠️ 补充说明：

• Phalcon 3.x 并未内置 getJsonRawBody()（需手动 json_decode($this->request->getRawBody())），因此你之前项目“能用”很可能是自定义封装或第三方扩展所致；
• 若需同时支持表单提交和 JSON 提交，可做类型判断：

if ($this->request->isJson()) {     $input = $this->request->getJsonRawBody(true); } else {     $input = $this->request->getPost(); }

总之，在构建 restful API 时，应主动选择与客户端 Content-Type 匹配的解析方式：表单用 getPost()，JSON 用 getJsonRawBody()——二者定位不同，不可混用。