PHP增删改查接口必须返回JSON格式数据并设置Content-Type头,Ajax需匹配method和data类型,JSON请求用php://input读取,成功与否应以code字段而非HTTP状态码判断。

PHP 增删改查接口必须返回 JSON 格式数据
Ajax 请求默认接收的是文本响应,但前端 JavaScript 处理起来最方便的是 JSON。所以 PHP 后端不管做 INSERT、UPDATE、DELETE 还是 SELECT,最后都要用 json_encode() 输出,并设置正确的响应头:
header('Content-Type: application/json; charset=utf-8');
echo json_encode(['code' => 0, 'msg' => '删除成功', 'data' => []]);
常见错误:忘了 header() 或直接 echo 普通字符串(比如 "success"),导致前端 response.json() 报错 Unexpected token。
注意:不要在输出 JSON 前有任何 echo、var_dump、空格或 BOM 字符,否则 JSON 解析失败。
Ajax 请求要明确 method 和 data 类型
增删改查对应 HTTP 方法不是硬性规定,但按惯例更清晰:
立即学习“PHP免费学习笔记(深入)”;
-
GET用于查询(SELECT),参数走 URL(如?id=123) -
POST用于新增(INSERT),数据放body -
PUT或POST(带_method=PUT)用于修改(UPDATE) -
DELETE用于删除(DELETE),ID 可走 URL 或 body
jQuery 示例中容易漏掉 contentType: 'application/json'(当传 JSON 字符串时),或误设 dataType: 'json' 却没让后端真正返回 JSON —— 这两者必须匹配。
PHP 接收 Ajax 数据不能只依赖 $_POST
Ajax 发送 application/json 请求体时,数据不在 $_POST 里,而是在 php://input 流中:
$raw = file_get_contents('php://input');
$data = json_decode($raw, true);
$id = $data['id'] ?? null;
而如果前端用 FormData 或普通键值对(contentType: 'application/x-www-form-urlencoded'),才用 $_POST 或 $_REQUEST。
常见坑:$_POST 在 JSON 请求下永远为空,硬查会出逻辑错误;反过来,用 file_get_contents('php://input') 处理表单数据也读不到 —— 因为已被 PHP 自动解析进 $_POST 了。
前端 success / error 回调不等于 HTTP 状态码成功
jQuery 的 success 只表示请求发出去且收到响应(哪怕后端返回 500 或 404,只要没网络异常就进这里);现代 fetch 更严格,response.ok 才表示状态码在 200–299 之间。
真正判断操作是否成功,得看后端返回的业务字段,比如:
if (data.code === 0) {
// 成功:刷新列表、清空表单
} else {
// 失败:提示 data.msg,不跳页也不清空
}
别把 200 OK 当作“数据库执行成功”——它只代表 PHP 脚本跑完了,可能里面 SQL 报错、权限不足、唯一键冲突,都得靠你自定义的 code 字段来区分。
实际开发中,code 字段比 HTTP 状态码更可靠,因为 Nginx 或 PHP-FPM 层的错误(比如超时、内存溢出)根本到不了你的 PHP 逻辑里。











