phpEnv本地HTTPS配置失败主因是证书路径错误或nginx未读取私钥:路径须用正斜杠(如C:/phpenv/certs/xxx.pem),证书和私钥必须含完整PEM标记且无密码;启用HTTPS后需手动重启nginx、检查443端口占用,并在nginx配置中添加fastcgi_param HTTPS on;以确保$_SERVER['HTTPS']正确识别。

phpEnv 本地 HTTPS 配置失败,90% 是因为证书路径没对上、或 nginx 没读到私钥——它不认 Windows 路径反斜杠,也不接受 PEM 里缺 BEGIN/END 标记的“半截证书”。
phpEnv 的 nginx 配置里 SSL 证书路径怎么写才有效
phpEnv 默认用 nginx,而它的配置生成器(右键站点 → “配置”)只负责把路径写进 nginx.conf,但不会校验路径是否存在、格式是否合法。常见错误是直接选了 .crt 和 .key 文件,却忽略了:
- 路径必须用正斜杠
/,不能用 Windows 默认的反斜杠\(比如C:/phpenv/certs/shop.test.crt✅,C:\phpenv\certs\shop.test.crt❌) - 证书文件(.crt)必须是完整 PEM 格式:开头有
-----BEGIN CERTIFICATE-----,结尾有-----END CERTIFICATE-----;中间不能混入空行或注释 - 私钥文件(.key)同理,必须含
-----BEGIN PRIVATE KEY-----/-----END PRIVATE KEY-----,且不能被密码保护(phpEnv 的 nginx 不支持输入密码) - 如果用了
mkcert生成的证书,它默认输出的是shop.test.pem(证书)和shop.test-key.pem(私钥),这两个文件可直接用,别去重命名或合并
为什么 phpEnv 点了“启用 HTTPS”还是打不开 https://localhost
点保存后,phpEnv 并不会自动重启 nginx,也不会检查 443 端口是否被占用。实际生效要靠手动干预:
- 确认
nginx.conf中对应 server 块已包含listen 443 ssl;,不是只有listen 80; - 检查是否已有其他程序占用了 443 端口(比如 Skype、IIS、另一个 nginx 实例),可用命令
netstat -ano | findstr :443查看 PID,再用任务管理器结束 - phpEnv 的“重启服务”按钮有时不生效,建议直接进
phpenv/nginx/目录,双击nginx-stop.bat再双击nginx-start.bat - 浏览器访问
https://localhost报ERR_CONNECTION_REFUSED?说明 nginx 根本没在监听 443;报ERR_SSL_PROTOCOL_ERROR?大概率是证书路径错或 PEM 格式损坏
$_SERVER['HTTPS'] 在 phpEnv 里为什么总是空
phpEnv 的 nginx 默认没传 HTTPS=on 给 PHP-FPM,所以即使页面能打开,PHP 代码里 $_SERVER['HTTPS'] 还是空字符串,导致 Laravel、WordPress 等框架生成的 URL 仍是 http://。
立即学习“PHP免费学习笔记(深入)”;
必须手动编辑 nginx 的 server 配置块,在 location ~ \.php$ 区域内加一行:
fastcgi_param HTTPS on;
注意不是 HTTPS=on,也不是 HTTP_X_FORWARDED_PROTO——phpEnv 是直连,没有代理层。漏掉这行,所有依赖 $_SERVER['HTTPS'] 判断协议的 PHP 逻辑都会失效。
用 mkcert 生成的证书在 phpEnv 里怎么放最省事
别折腾 OpenSSL 手动签,也别改 hosts 或注册域名。就三步:
- 用
choco install mkcert安装(没 Chocolatey 就先装),然后运行mkcert -install(弹窗点“安装”) - 在 cmd 里 cd 到你准备放证书的目录,执行
mkcert localhost 127.0.0.1 ::1,会生成localhost+2.pem和localhost+2-key.pem - 把这两个文件复制到 phpEnv 的任意目录(比如
phpenv/certs/),然后在站点配置里填入完整正斜杠路径:C:/phpenv/certs/localhost+2.pem和C:/phpenv/certs/localhost+2-key.pem
Chrome 和 Edge 会信任这个证书(因为 mkcert -install 已把它加进系统根证书库),不用点“高级→继续访问”。Firefox 需单独导入根证书(路径在 %LOCALAPPDATA%\mkcert\ 下的 rootCA.pem)。



















