如何设置phpEnv+Nginx实现非www域名自动跳转到www版本？

本文共计782个文字，预计阅读时间需要4分钟。

当然可以，请提供需要改写的伪原创开头内容，我会按照您的要求进行修改。

为什么 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; }

注意要点：

立即学习“PHP免费学习笔记（深入）”；

• 两个 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 支持 —— 这俩一错，整个跳转链就断在第一步。