phpenv 中 if 判断跳转无效，因 nginx 反模式、模板覆盖及执行不可靠；正确做法是新增独立 server 块分别处理 http 和 https 的非 www 跳转，并确保证书支持 san。
phpEnv 默认不处理非 www 域名跳转，必须手动加独立 server 块，且不能和主站点混在同一个块里 —— 否则跳转会失效或循环。
为什么 phpEnv 的 Nginx 配置里加 if ($host = example.com) 没用
phpEnv 自动生成的配置通常把 server_name 写成 example.com www.example.com，再用 if 判断跳转，这在 Nginx 里属于反模式：
-
if在location外使用时行为不可靠，尤其配合return容易被忽略或延迟执行 - phpEnv 的模板可能覆盖或重写你的
if规则（比如 certbot 自动注入的区块） - 多个
if嵌套或顺序错乱会导致跳转目标变成https://example.com而不是https://www.example.com
正确做法：新增一个纯跳转用的 server 块
在 phpEnv 的站点配置文件（如 /phpenv/nginx/vhost/example.com.conf）末尾追加：
server {
listen 80;
server_name example.com;
return 301 https://www.example.com$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com;
ssl_certificate /phpenv/ssl/example.com.crt;
ssl_certificate_key /phpenv/ssl/example.com.key;
return 301 https://www.example.com$request_uri;
}
注意要点：
- 两个
server块必须分开写，listen 80和listen 443 ssl不能合并 -
ssl_certificate路径要和你实际证书位置一致，否则 HTTPS 跳转会因证书错误中断 - 不要在主站点块里写
server_name example.com www.example.com—— 把非 www 单独剥离出去，避免匹配歧义
HTTPS 下跳转到 www 时容易漏掉的坑
很多人只配了 HTTP 跳转，结果用户直接访问 https://example.com 就卡住或报证书域名不匹配：
- 浏览器对
https://example.com的请求不会自动降级到 HTTP，所以listen 80块完全不生效 - 若没配
listen 443的跳转块，Nginx 会尝试用主站点的 SSL 配置响应，但server_name example.com可能没绑定证书，导致连接失败 - 证书必须同时覆盖
example.com和www.example.com（即 SAN 证书），否则listen 443块无法启动
验证跳转是否生效的三步检查
改完配置别急着重载，先逐项确认：
- 运行
nginx -t看语法是否通过；常见失败是ssl_certificate路径错或权限不足（需 nginx 用户可读） - 用
curl -I http://example.com和curl -I https://example.com分别测试，看Location头是否指向https://www.example.com - 清空浏览器 DNS 缓存或换无痕窗口访问，避免本地
HSTS强制 HTTPS 导致误判
最常被忽略的是 HTTPS 跳转块的证书路径和 SAN 支持 —— 这俩一错，整个跳转链就断在第一步。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
