phpEnv无跨域开关，必须在Nginx配置的location块中手动添加带always参数的add_header指令，并显式处理OPTIONS预检请求返回204，否则跨域失败。
phpEnv 本身不提供跨域配置入口，所有跨域响应头必须在 Nginx 配置文件中手动添加 add_header 指令 —— 这是唯一有效方式。
为什么 phpEnv 的 Nginx 配置里找不到“跨域开关”
phpEnv 是一个 Windows 下的 PHP 环境集成包（类似 XAMPP），它打包了 Nginx、PHP、MySQL，但没封装任何跨域管理界面或快捷配置项。它的 Nginx 配置完全依赖你编辑原始 conf 文件，不存在「勾选启用跨域」这类操作。
常见误解是试图在 phpEnv 控制面板、PHP.ini 或 .htaccess 里改跨域，这些地方对 Nginx 跨域无效：
-
php.ini中的设置只影响 PHP 自身输出的 header，而 phpEnv 默认用 Nginx 直接代理 PHP-FPM，PHP 的header()可能被 Nginx 缓存或覆盖 - phpEnv 不启用 Apache 模块，所以
.htaccess文件完全不生效 - 控制面板里没有 CORS 相关字段，所有修改必须进配置文件
在 phpEnv 的 nginx.conf 中加 add_header 的实操步骤
phpEnv 的 Nginx 主配置通常位于：C:\phpenv\nginx\conf\nginx.conf（路径以你实际安装为准）。关键不是全局加，而是加在 location 块内，且必须带 always 参数，否则对 301/302 或错误响应不生效。
立即学习“PHP免费学习笔记（深入）”；
例如，你要让前端 http://localhost:8080 访问 /api/ 接口跨域成功：
location /api/ {
proxy_pass http://127.0.0.1:9000; # 假设后端 PHP-FPM 监听 9000
add_header 'Access-Control-Allow-Origin' 'http://localhost:8080' always;
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS' always;
add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization, X-Requested-With' always;
add_header 'Access-Control-Allow-Credentials' 'true' always;
<pre class='brush:php;toolbar:false;'>if ($request_method = 'OPTIONS') {
add_header 'Access-Control-Max-Age' 1728000;
add_header 'Content-Type' 'text/plain charset=UTF-8';
add_header 'Content-Length' 0;
return 204;
}}
注意几个硬性条件：
- 若需
Access-Control-Allow-Credentials: true，Access-Control-Allow-Origin绝对不能写*，必须是具体协议+域名+端口（如http://localhost:8080） -
add_header ... always中的always是必须的 —— phpEnv 自带的 Nginx 版本（通常是 1.18–1.22）默认只对 2xx 响应加 header，而 4xx/5xx 或重定向时会丢掉，导致预检失败 - 不要在
server块顶层直接写add_header，Nginx 会继承到所有 location，可能污染静态资源（如 CSS/JS 文件不该带 CORS 头）
改完配置后 reload 失败？检查这三点
phpEnv 的 Nginx 不支持 systemd，reload 必须用其自带命令或手动操作：
- 先确认语法：打开命令行，执行
C:\phpenv\nginx\nginx.exe -t，看到success才能继续 - 再 reload：用 phpEnv 控制面板点「Restart Nginx」，或手动执行
C:\phpenv\nginx\nginx.exe -s reload - 如果提示
bind() to 0.0.0.0:80 failed，说明端口被占用（常见于 Skype、IIS、另一份 Nginx），需先停掉冲突服务
reload 成功后，用浏览器开发者工具 → Network → 点开任意一个 /api/ 请求，在 Response Headers 里搜 access-control-allow-origin，必须真实出现才算生效。
前端发请求还是报错？重点查 OPTIONS 是否被拦截
很多问题表面是跨域，实际是预检（OPTIONS）失败。常见现象：
- Chrome 控制台报
Failed to load http://...: No 'Access-Control-Allow-Origin' header is present，但 Network 里看不到 OPTIONS 请求 —— 说明浏览器根本没发出去，可能是 Nginx 没配if ($request_method = 'OPTIONS')块，或该块没 return 204 - 能看到 OPTIONS 请求，状态码却是 405（Method Not Allowed）—— 说明 Nginx 没允许 OPTIONS 方法，需确认
location块里有if判断并return 204 - OPTIONS 返回 204，但后续 POST 仍失败 —— 检查
Access-Control-Allow-Headers是否漏了前端实际发送的 header（比如X-Token或Content-Type: application/json）
最稳妥的做法：先用 curl 模拟预检，验证 Nginx 行为是否符合预期：
curl -X OPTIONS http://localhost/api/test \ -H "Origin: http://localhost:8080" \ -H "Access-Control-Request-Method: POST" \ -H "Access-Control-Request-Headers: Content-Type" \ -I
看返回里有没有 Access-Control-Allow-Origin 和 204 状态码。
