phpEnv是轻量级Windows PHP集成环境，需手动配置Web服务器以支持Vue的History路由（如FallbackResource）和跨域（如add-response-header），并依赖日志排查问题。
phpEnv 是一个轻量级的 Windows PHP 集成环境（类似 phpStudy 但更精简），默认不带 Apache/Nginx 重写支持，也不自动处理 Vue 的 History 模式路由和跨域请求——这正是部署 Vue + PHP 前后端分离项目时最常卡住的两个点。
phpEnv 中 Vue 静态资源 404（尤其是 /xxx 路由）
Vue 使用 vue-router 的 history 模式时，访问 /about 会直接被 phpEnv 的内置 Web 服务器当作真实路径查找，而 dist 目录下根本没有 about.html，结果返回 404。
- phpEnv 默认用的是
LightTPD或精简版Apache，不读取.htaccess，所以 Apache 的RewriteRule配置无效 - 必须手动修改 phpEnv 对应的 Web 服务器配置文件：如果是 LightTPD，编辑
phpenv\lighttpd\conf\lighttpd.conf；如果是 Apache，改phpenv\apache\conf\httpd.conf - 在
<Directory "你的 dist 路径">块内加入：FallbackResource /index.html（LightTPD）或DirectoryIndex index.html+AllowOverride All并确保mod_rewrite已启用（Apache） - 改完重启 phpEnv 服务，否则不生效
Vue 开发时调用 PHP 接口报 CORS 错误
本地开发用 npm run serve 启动 Vue（端口如 5173），PHP 接口跑在 phpEnv 的 80 端口，浏览器判定为跨域，预检请求（OPTIONS）直接被拦，连 PHP 文件都进不去。
vue-composition-api-best-practices
下载
Vue 3 组合式 API 与 最佳实践，涵盖代码组织、useXxx 模式、组合式函数设计、Store 集成、响应式优化及功能抽取。
- 别在 PHP 里零散加
header('Access-Control-Allow-Origin: *')—— 这对预检请求无效，且可能被重复输出导致 header 冲突 - 正确做法是在 phpEnv 的 Web 服务器层统一加响应头：LightTPD 在
lighttpd.conf加setenv.add-response-header = ("Access-Control-Allow-Origin" => "*", "Access-Control-Allow-Methods" => "GET,POST,OPTIONS", "Access-Control-Allow-Headers" => "Content-Type, Authorization") - Apache 则在对应
<Directory>或虚拟主机配置里加Header set Access-Control-Allow-Origin "*"，并启用mod_headers - 如果只是临时调试，Vue 项目根目录建
vite.config.js（Vite）或vue.config.js（Vue CLI），配server.proxy把/api代理到http://localhost，绕过浏览器跨域检查
PHP 接口返回 JSON 但前端解析失败
常见现象是 Axios 收到响应，response.data 是空对象或字符串，甚至直接抛 Unexpected token < in JSON 错误。
立即学习“PHP免费学习笔记（深入）”；
- 先确认 PHP 接口是否真返回了 JSON：用 curl 或 Postman 直接请求
http://localhost/api/user.php，看响应体开头是不是{或[，而不是 HTML（比如 phpEnv 的 404 页面或 PHP 错误提示） - PHP 脚本顶部必须加
header('Content-Type: application/json; charset=utf-8');，且不能有任何 echo/print 输出在json_encode()前（包括 BOM、空格、调试语句） - 如果用了框架（如 ThinkPHP6），确保没开启调试模式（
app_debug=true），否则会混入 HTML 调试信息 - Vue 端用 Axios 时，避免手动
JSON.parse()，直接用response.data；若后端返回非标准结构（如外层包了{code:0,data:{...}}），应在 Axios 的transformResponse或封装的 request 函数里统一解包
真正麻烦的不是配置本身，而是 phpEnv 没有图形化界面提示哪一步错了——所有问题都得靠看日志：LightTPD 日志在 phpenv\lighttpd\logs\error.log，PHP 错误在 phpenv\php\logs\php_error.log。不打开这些文件，光刷新页面猜，三天也调不完。
