nginx在phpenv中需手动修改vhost下站点配置文件，用map或顶层if+return 302实现ua跳转，禁用location内if+rewrite，避免301缓存，并通过cookie（如prefer=mobile）支持用户手动切换版本。
Nginx 在 phpEnv 环境下无法靠面板开关实现 UA 跳转，必须手动改配置文件；跳转逻辑本身和标准 Nginx 一致，但路径、reload 方式、变量作用域有特定限制。
phpEnv 的 Nginx 配置文件在哪
phpEnv 默认把站点配置放在 C:\phpenv\nginx\conf\vhost\（Windows）或 /usr/local/phpenv/nginx/conf/vhost/（Linux/macOS），每个站点一个 .conf 文件。不要改 nginx.conf 主配置，否则升级 phpEnv 可能被覆盖。
修改后需用 phpEnv 面板的「重启 Nginx」按钮生效，不能直接执行 nginx -s reload —— 因为 phpEnv 启动的是带自定义参数的进程，手动 reload 会失败或无响应。
if + rewrite 在 phpEnv 中容易 500 的原因
phpEnv 自带的 Nginx 版本（多为 1.20.x 或 1.22.x）对 if 嵌套和 rewrite 在 location 内的支持较弱，常见报错：nginx: [emerg] "rewrite" directive is not allowed here。
- 错误写法：在
location /块里直接写if ($http_user_agent ~* ...)+rewrite - 正确位置：
if必须放在server块顶层，不能嵌套在location、if或limit_except里 - 更稳方案：改用
map指令预定义变量，它支持在http或server上下文声明，且 phpEnv 全版本兼容
移动端跳转必须用 return 302，别碰 301
phpEnv 多用于本地开发或测试环境，若误配 permanent（即 301），浏览器会强缓存跳转，导致你改了配置也刷不出来，只能清浏览器 DNS 和重定向缓存，甚至要换隐身窗口验证。
实际配置只用这一行就够了（放在 server 块内，PC 站点配置中）：
if ($http_user_agent ~* "(Mobile|Android|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini)") {
return 302 https://m.example.com$request_uri;
}
注意三点：
-
$request_uri包含完整路径+查询参数，$uri不含 query string，用错会导致 ?id=123 丢失 - 目标域名必须已存在且能被本地解析（比如 hosts 里加了
127.0.0.1 m.example.com） - 如果手机站也是 phpEnv 托管，确保它的
server_name包含m.example.com，否则 404
用户手动切换“电脑版”怎么持久生效
仅靠前端 JS 设置 Cookie 是无效的——Nginx 在请求刚进来时就完成了跳转，JS 还没执行。必须让 Nginx 在第一次判断前就读取用户偏好。
在 PC 站点的 server 块开头加这段：
set $is_mobile 0;
if ($http_cookie ~ "prefer=mobile") {
set $is_mobile 1;
}
if ($http_cookie ~ "prefer=pc") {
set $is_mobile 0;
}
if ($http_user_agent ~* "(Mobile|Android|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini)") {
set $is_mobile 1;
}
if ($is_mobile = 1) {
return 302 https://m.example.com$request_uri;
}
这样，用户点「电脑版」链接时带上 ?prefer=pc，后端 PHP 或静态页用 setcookie("prefer=pc", "", time()+3600, "/") 写入，下次请求 Nginx 就优先信任这个 Cookie，不再看 UA。
真正容易被忽略的是：Cookie 名称和值必须严格匹配正则中的字符串，prefer=pc 和 prefer= pc（带空格）不等价，Nginx 不会自动 trim。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
