登录
首页 >  文章 >  php教程

phpEnv配置本地HTTPS证书 phpEnv虚拟主机SSL设置

时间:2026-05-03 13:28:08 174浏览 收藏

各位小伙伴们,大家好呀!看看今天我又给各位带来了什么文章?本文标题《phpEnv配置本地HTTPS证书 phpEnv虚拟主机SSL设置》,很明显是关于文章的文章哈哈哈,其中内容主要会涉及到等等,如果能帮到你,觉得很不错的话,欢迎各位多多点评和分享!

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

phpEnv配置本地HTTPS证书 phpEnv虚拟主机SSL设置

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://localhostERR_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://。

必须手动编辑 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.pemlocalhost+2-key.pem
  • 把这两个文件复制到 phpEnv 的任意目录(比如 phpenv/certs/),然后在站点配置里填入完整正斜杠路径:C:/phpenv/certs/localhost+2.pemC:/phpenv/certs/localhost+2-key.pem

Chrome 和 Edge 会信任这个证书(因为 mkcert -install 已把它加进系统根证书库),不用点“高级→继续访问”。Firefox 需单独导入根证书(路径在 %LOCALAPPDATA%\mkcert\ 下的 rootCA.pem)。

以上就是《phpEnv配置本地HTTPS证书 phpEnv虚拟主机SSL设置》的详细内容,更多关于phpenv的资料请关注golang学习网公众号!

资料下载
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>