XAMPP部署React项目+PHP后端教程
本文详细讲解了如何在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学习网公众号吧!
CSS双面卡片边框渲染问题解决方法
- 上一篇
- CSS双面卡片边框渲染问题解决方法
- 下一篇
- Symfony 中NoSQL查询转数组方法
-
- 文章 · php教程 | 3天前 | 面向对象 · PHP · PHP8.4 · Property Hooks · 代码重构 · PHP教程 Getter PHP 8.4 Property Hooks setter
- PHP 8.4 Property Hooks 实战:把 getter/setter 收回到属性声明里
- 464浏览 收藏
-
- 文章 · php教程 | 2星期前 | WEB开发 · 登录状态 · Cookie · PHP · session · session_start · php cookie session session_start PHPSESSID 登录态丢失
- PHP Session 登录态突然丢失怎么办:从 Cookie 到 session_start 一步步排查
- 196浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- ljg-skills
- ljg-skills 是李继刚开源的 AI 技能与提示词集合,面向大模型使用者整理了一批可复用的 prompt、角色设定和任务技能模板,适合用于学习提示词设计、搭建个人 AI 工作流和沉淀团队常用智能体能力。
- 3005次使用
-
- MELO音乐
- MELO音乐是一站式AI视频与音乐制作助手,对标suno, udio的高品质体验。提供伴奏生成、原创写词、无损导出、哼唱识曲、混音变声等全套音频与短视频编辑工具。无论是流行Kpop、电音说唱、民谣古风、摇滚儿歌还是商用轻音乐,MELO为你免费谱曲,轻松做同款!
- 2775次使用
-
- UniScribe
- UniScribe 是一款 AI 音视频转文字与内容整理工具,支持上传音频、视频文件或粘贴 YouTube 链接,自动生成转写文本、摘要、思维导图和关键问题,并支持多格式导出,适合会议记录、课程学习、访谈整理和内容创作复盘。
- 2714次使用
-
- 剧云
- 剧云是专业中文剧本创作平台,安全稳定运行十余年,集成AI编剧、剧本医生审核、人物小传、剧情关系图、大纲编写、多人协作、Word导入导出、版权管控功能,数据安全防护,轻松高效创作剧本。
- 2940次使用
-
- 万象有声
- 万象有声,一个专为有声创作者打造的新一代智能有声内容创作平台。平台提供专业的智能拆章、智能画本编辑、AI配音、AI生成音效、后期制作、智能对轨、智能审听等有声创作全流程工具,可以帮助创作者高效、低成本创作出引人入胜的有声作品。立即体验,让有声书制作更简单!
- 2890次使用
-
- 宝塔配置Ruby环境:RVM+Nginx反代教程
- 2026-05-29 501浏览
-
- unset函数作用范围详解
- 2026-05-29 501浏览
-
- VS Code配置Xdebug教程:PHP调试技巧全解析
- 2026-05-13 501浏览
-
- PHPEnv安装PhpMyAdmin教程详解
- 2026-05-07 501浏览
-
- TelegramBotWebApp数据验证技巧
- 2026-05-06 501浏览

