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

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中的和标签,路径是否都带/react/static/- 如果用了
BrowserRouter,必须加basename="/react",否则路由跳转后刷新直接 404
Apache 必须重写前端路由到 index.html
XAMPP 自带的 Apache 默认把 /react/some-path 当作真实文件或目录处理,找不到就返回 404。但 React 的路由是客户端行为,所有路径都该 fallback 到 index.html。
- 在
htdocs/react/.htaccess中放以下内容(确保 Apache 的mod_rewrite已启用):RewriteEngine On RewriteBase /react/ RewriteRule ^index\.html$ - [L] RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteRule . /react/index.html [L] - 若用 Windows 版 XAMPP,检查
httpd.conf中AllowOverride All是否对htdocs目录生效 - 别漏掉
RewriteBase—— 它必须和homepage值一致,否则重写目标错位
PHP 接口不能放在 React 源码里直调
开发时用 npm start,Axios 请求 /api/login.php 看似能发出去,其实是因为 Webpack Dev Server 把这类请求代理到了 PHP 服务;但 build 后扔进 XAMPP,浏览器会直接向 http://localhost/react/api/login.php 发请求——而这个路径下根本没 PHP 文件,Apache 也不会执行它。
- PHP 文件必须放在 Apache 可执行的路径下,比如
htdocs/api/login.php,而非src/api/或build/api/ - Axios 请求 URL 改成绝对路径:
http://localhost/api/login.php,而不是相对路径/api/login.php(后者会被拼成/react/api/login.php) - PHP 文件开头务必加 CORS 头,否则浏览器因跨域拦截:
header("Access-Control-Allow-Origin: http://localhost"); header("Access-Control-Allow-Methods: POST, GET, OPTIONS"); header("Access-Control-Allow-Headers: Content-Type");
PHP 错误不显示?先关 display_errors
React 请求 PHP 接口返回空白或 500,但页面没报错信息?大概率是 PHP 配置让错误藏起来了。
- 打开
C:\xampp\php\php.ini(Windows)或/opt/lampp/etc/php.ini(Linux/macOS) - 确认
display_errors = Off(防止错误混在 JSON 里破坏格式) - 开启日志:
log_errors = On+error_log = "C:\xampp\php\logs\php_error.log" - 改完重启 Apache,然后看日志文件——90% 的 PHP 逻辑错误(如未定义变量、SQL 连接失败)都在那儿
最常被忽略的是:PHP 接口和 React 静态资源虽然同属 XAMPP,但必须严格区分路径层级和执行权限。把 PHP 文件塞进 build/ 目录、忘了配 basename、或者 .htaccess 权限没放开,都会导致“看起来部署完了,实际一碰就崩”。
理论要掌握,实操不能落!以上关于《XAMPP部署React项目+PHP后端教程》的详细介绍,大家都掌握了吧!如果想要继续提升自己的能力,那么就来关注golang学习网公众号吧!
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
501 收藏
-
429 收藏
-
181 收藏
-
228 收藏
-
128 收藏
-
483 收藏
-
402 收藏
-
459 收藏
-
141 收藏
-
182 收藏
-
259 收藏
-
180 收藏
-
353 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 立即学习 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 立即学习 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 立即学习 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 立即学习 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 立即学习 485次学习