React项目部署到XAMPP需四步：设homepage为"/react"、BrowserRouter加basename="/react"、.htaccess配置RewriteBase /react/并重写至index.html、PHP接口放htdocs/api下且配CORS头。
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中的<script></script>和<link>标签，路径是否都带/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 也不会执行它。
构建 Shopify 嵌入式应用（Embedded App）的开发技能：基于 @shopify/shopify-app-react-router + React Router v7 + Admin API 2026-04。覆盖 shopifyApp 配置、authenticate.admin 的 GraphQL/REST 调用、Webhook 校验、Session 存储、订阅计费、App Bridge 导航、部署，并新增：适用场景判断、安全最佳实践、错误处理与容错、最佳实践、常见问题 FAQ、高级场景。G
立即学习“PHP免费学习笔记（深入）”；
- 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 权限没放开，都会导致“看起来部署完了，实际一碰就崩”。
