Nginx强制HTTPS跳转需配置两个独立server块：80端口仅return 301跳转，443端口启用SSL并配置PHP-FPM；证书须用绝对路径、无密码、权限正确；代码中避免硬编码HTTP链接，本地localhost建议白名单豁免跳转。
phpEnv 是 Windows 下的 PHP 一键环境，底层用的是 Nginx + PHP-FPM，它不自带图形化 HTTPS 配置界面，强制跳转必须手动改 Nginx 配置文件，否则浏览器访问 http:// 仍能打开，且 Cookie、AJAX、Session 全部可能失效。
Nginx 的 server 块必须拆成两个：80 和 443 端口独立监听
phpEnv 默认只配了一个 server 块（监听 80 端口），加了 SSL 配置后也不能复用——Nginx 不允许在同一个 server 块里混用 listen 80 和 ssl。必须显式写出两个 server 块：
- 一个只监听
80，仅做return 301 https://$host$request_uri; - 另一个监听
443 ssl http2，放证书路径、PHP 处理逻辑等全部正式配置 - 两个块的
server_name必须完全一致（如localhost或你的域名），否则跳转后 Host 可能错乱
证书路径要写对，且权限不能出错
phpEnv 的 Nginx 运行用户是 SYSTEM（Windows 服务模式），它无法读取被系统隐藏或权限受限的证书文件。常见错误包括：
- 证书放在中文路径、桌面、OneDrive 或带空格的目录（如
C:\Users\张三\certs\）→ 改到C:/phpenv/certs/这类纯英文无空格路径 - 用了相对路径（如
cert.pem）→ 必须写绝对路径，且正斜杠（/）而非反斜杠（\）：ssl_certificate C:/phpenv/certs/fullchain.pem; - 私钥文件没去除密码（OpenSSL 生成时输过 pass phrase）→ phpEnv 启动 Nginx 会失败，需用
openssl rsa -in privkey.pem -out privkey-nopass.pem去密
跳转后出现混合内容（Mixed Content）警告
浏览器控制台报 Mixed Content: The page at 'https://...' was loaded over HTTPS, but requested an insecure resource 'http://...'，说明页面里还有硬编码的 http:// 资源链接。这不是 Nginx 配置问题，而是 PHP 代码或模板里的坑：
立即学习“PHP免费学习笔记（深入）”；
-
<img src="http://localhost/assets/logo.png">→ 改成<img src="/assets/logo.png">（协议相对路径或绝对路径） - ThinkPHP 中用
url('index/index')生成链接，但没设URL_SECURE→ 在.env加APP_URL=https://localhost，或中间件里调用\URL::forceScheme('https') - Laravel 的
asset()返回http://→ 确保AppServiceProvider::boot()中已执行\URL::forceScheme('https')，且只在 production 环境生效 - PHP 自己拼接跳转地址，如
header('Location: http://' . $_SERVER['HTTP_HOST'] . '/login');→ 改成https://或用$_SERVER['REQUEST_SCHEME']动态判断
本地开发用 localhost 时，别对所有请求都跳转
phpEnv 常用于本地开发，而 localhost 无法申请合法证书（Let’s Encrypt 不签），强行跳转会卡死。必须加白名单过滤：
- Nginx 层最稳妥：在
listen 80的server块里加条件判断，例如：if ($host != 'localhost') { return 301 https://$host$request_uri; } - 不要用
$scheme或$_SERVER['HTTPS']判断，Windows 下 phpEnv 的 CGI 模式常导致这些变量不可靠 - 如果连
localhost也要测 HTTPS，可用 mkcert 生成本地可信证书，再按前述方式配进 Nginx
最易被忽略的一点：phpEnv 修改配置后必须「以管理员身份重启 Nginx 服务」，双击托盘图标重启无效；且浏览器要硬刷新（Ctrl+F5）并清空 HSTS 缓存，否则 301 跳转会永久缓存，连改配置都看不到效果。
