当前位置:首页 > 文章列表 > 文章 > php教程 > XAMPP部署React项目+PHP后端教程

XAMPP部署React项目+PHP后端教程

2026-05-19 19:34:34 0浏览 收藏
本文详细讲解了如何在XAMPP环境下正确部署React前端单页应用与PHP后端接口的完整协作方案,直击开发者常踩的“部署即崩”痛点:从React构建产物适配子路径(homepage与basename配置)、Apache重写规则精准fallback至index.html,到PHP接口的物理路径规划、CORS跨域处理及错误日志排查,每一步都紧扣XAMPP的运行机制,帮你避开将React直接丢进htdocs、混淆开发代理与生产环境请求、忽略RewriteBase一致性等致命误区,真正实现前后端在同一个本地服务器下稳定共存、无缝通信。

如何在 XAMPP 环境中部署 React 项目并配合 PHP 后端

React 项目不能直接扔进 XAMPP 的 htdocs 目录就跑起来——它不是纯静态 HTML,而是依赖前端路由、资源路径和构建产物结构的单页应用(SPA)。PHP 后端也不能靠 npm start 启动,必须由 Apache 或其他 PHP 兼容服务器执行。两者要共存,关键在路径隔离与请求分发。

React 构建产物必须适配子路径(如 /react)

如果你把 React 项目 build 后放在 htdocs/react 下,但没改配置,访问 http://localhost/react/ 会加载 HTML,但所有 JS/CSS 路径仍默认从根目录(/static/)请求,404 就不可避免。

  • package.json 中设 "homepage": "/react"(不是完整 URL,也不是 ./react
  • npm run build 后检查 build/index.html 中的