PHPAJAX交互实战教程

PHP与AJAX交互远不止写几个API那么简单，真正卡住开发者的往往是数据传不进、JSON解析失败、跨域请求无声无息被拦截这三大“静默杀手”——本文直击核心痛点，手把手讲清：前端Content-Type如何精准决定后端该用$_POST还是php://input读取数据；为什么header('Content-Type: application/json')必须在任何输出前调用，以及BOM、空行等隐形陷阱如何让JSON解析直接崩溃；还有跨域中OPTIONS预检的强制触发机制、完整响应头配置及credentials与Origin的严格匹配要求，帮你绕过90%的线上黑屏故障。

PHP 与 AJAX 交互不是“学个语法就能跑通”的事，关键在搞清数据怎么进、怎么出、中间哪一环断了就全黑屏。绝大多数人卡在 $_POST 为空、response.json() 报错、跨域直接被拦这三处——下面直奔实操。

怎么判断该用 $_POST 还是 file_get_contents('php://input')

前端发什么格式，后端就得配什么读法，没商量余地。

• 前端用 fetch + JSON.stringify({name: 'a'}) + headers: {'Content-Type': 'application/json'} → 后端必须用 file_get_contents('php://input') 拿原始体，再 json_decode($raw, true)
• 前端用 FormData 或 fetch 发 body: 'name=a&age=25' + headers: {'Content-Type': 'application/x-www-form-urlencoded'} → 后端才能用 $_POST['name']
• 打印 $_SERVER['CONTENT_TYPE'] 和 var_dump($_POST) 是最快定位方式：如果 $_POST 是空数组但 CONTENT_TYPE 是 application/json，那就别挣扎了，换 php://input

header('Content-Type: application/json') 必须写在 echo 前面

这个 header 不是“建议加”，是 response.json() 解析的硬性门槛。Safari、旧版 Edge 会直接抛 Unexpected end of JSON input，哪怕你 echo 出来的是完美 JSON。

• 所有输出（echo、print、甚至 PHP 文件末尾多一个空行或 BOM）都必须在 header() 之后
• 调试时加一句 var_dump(headers_sent());，返回 true 就说明头已经发出去了，再调 header() 无效
• 常见陷阱：某个 require 的配置文件末尾有 ?> 换行，或者 UTF-8 BOM 隐形字符，都会导致 header 失效

跨域请求失败，光加 Access-Control-Allow-Origin 不够

浏览器报 No 'Access-Control-Allow-Origin' header is present，很多人立刻加 header('Access-Control-Allow-Origin: *')，结果还是 403 或直接不发请求——因为 OPTIONS 预检根本没过。

• 带自定义 header（如 Authorization）、用 PUT/DELETE、或 Content-Type 不是 application/x-www-form-urlencoded 时，浏览器必先发一次 OPTIONS 请求
• PHP 端必须显式响应 OPTIONS：if ($_SERVER['REQUEST_METHOD'] === 'OPTIONS') { header('HTTP/1.1 200 OK'); exit; }
• 完整跨域头至少要这三句：header('Access-Control-Allow-Origin: https://your-frontend-domain.com');（不能用 * 如果带 credentials）、header('Access-Control-Allow-Methods: POST, GET, OPTIONS');、header('Access-Control-Allow-Headers: Content-Type, Authorization');

最易被忽略的是：预检通过后，后续实际请求仍可能因 session 或 cookie 携带失败而静默中断——这时得确认前端 fetch 是否开了 credentials: 'include'，且后端 Access-Control-Allow-Credentials 和 Origin 值是否严格匹配。

本篇关于《PHPAJAX交互实战教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！