PHP与前端框架（Vue/React）全栈开发最佳实践-php教程-PHP中文网

php与vue/react对接核心在于接口契约稳定：必须显式设置content-type: application/json，规范cors头，统一json结构与http状态码，避免空白输出和credentials配置遗漏，前端需拦截401/422并记录请求id以精准排障。

php与前端框架（vue/react）全栈开发最佳实践

PHP 与 Vue/React 全栈开发，核心不是“能不能连上”，而是「接口契约是否稳定、错误是否可定位、部署是否解耦」。只要后端返回的 JSON 结构清晰、HTTP 状态码合理、CORS 配置无歧义，前端框架几乎不会出兼容性问题——真正卡住进度的，往往是跨域调试失败、401 响应没被拦截、或 PHP 输出了意外空格导致 JSON 解析失败。

PHP 接口必须显式设置 `Content-Type: application/json`

很多 PHP 文件直接 echo json_encode(...)，但忘了设头。浏览器收到 text/html 类型响应时，fetch 不会报错，但 response.json() 会抛 SyntaxError: Unexpected token——因为实际返回的是带 HTML 模板的混合内容。

必须在 json_encode 前调用 header('Content-Type: application/json; charset=utf-8')
避免在接口文件顶部或底部有空白行、BOM 字符或 echo/var_dump 遗留输出（可用 ob_clean() + ob_end_flush() 临时兜底）
ThinkPHP/Laravel 等框架推荐用内置方法：return json([...]) 或 response()->json(...)，它们自动处理 header 和编码

Vue/React 中请求 PHP API 时，别信默认 `baseURL`

开发时习惯配 axios.create({ baseURL: '/api' })，但生产环境 PHP 后端可能部署在子路径（如 https://example.com/backend/），而前端静态资源托管在根域名。此时 /api/users 会被发到 https://example.com/api/users，而非后端真实地址。