设 $cfg['ForceSSL'] = true; 即可强制 HTTPS,但需确保服务器真实启用 HTTPS,否则会无限跳转或报错;提示“HTTPS 不匹配”是因为 phpMyAdmin 检测到请求为 HTTP 而配置要求 HTTPS,但 Web 服务器未实际提供 HTTPS 服务(如未配证书、未监听 443、反向代理未透传 X-Forwarded-Proto)。

直接改 $cfg['ForceSSL'] = true; 就行,但必须确保服务器已实际启用 HTTPS,否则会无限跳转或报错。
为什么设了 ForceSSL 还会提示“HTTPS 不匹配”?
这个提示不是警告,而是明确告诉你:phpMyAdmin 检测到当前请求是 HTTP,但配置要求强制 HTTPS,而服务器并未真正提供 HTTPS 服务(比如 Nginx/Apache 没配 SSL 证书、没监听 443 端口,或反向代理没透传 X-Forwarded-Proto)。
常见错误现象包括:
- 访问
https://地址时跳回http://或白屏 - 浏览器显示“不安全”或证书错误,即使你填了证书路径
- phpMyAdmin 底部持续弹出“服务器和客户端上指示的HTTPS之间不匹配”
根本原因不是 phpMyAdmin 配错了,而是它依赖 Web 服务器真实提供 HTTPS——它自己不终止 TLS,只做协议检查。
立即学习“PHP免费学习笔记(深入)”;
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
config.inc.php 中 ForceSSL 的正确写法和位置
在 config.inc.php 文件中找到类似 $cfg['Servers'][$i]['host'] 的区块附近,添加或修改这一行(不要加在 $cfg['Servers'] 数组内部):
$cfg['ForceSSL'] = true;
注意:
- 该选项是全局生效,影响所有服务器配置项
- 值必须是 PHP 布尔字面量
true,不能写成字符串'true'或数字1 - 如果用了宝塔面板,**不要**单独给 phpMyAdmin 配子域名 HTTPS,应使用宝塔自带的
/phpmyadmin代理路径 + 主站 HTTPS - Apache 用户需确认
mod_ssl已启用,且虚拟主机配置中包含SSLEngine on和有效证书路径
ForceSSL 生效后还要检查的三件事
仅设 $cfg['ForceSSL'] = true; 不够,以下任一缺失都会导致连接失败或降级:
-
PmaAbsoluteUri必须显式设为 HTTPS 地址,例如:$cfg['PmaAbsoluteUri'] = 'https://example.com/phpmyadmin/';(末尾斜杠不能少) - Web 服务器必须把
X-Forwarded-Proto: https头正确传递给 PHP,Nginx 需加:proxy_set_header X-Forwarded-Proto $scheme; - PHP 的
$_SERVER['HTTPS']要能被正确识别——某些 FastCGI 配置下需手动设置:fastcgi_param HTTPS on;
最容易被忽略的是最后一点:当 phpMyAdmin 运行在反向代理后(如宝塔、Cloudflare),$_SERVER['HTTPS'] 默认为空,ForceSSL 就会失效或误判。这时候不修服务器配置,光改 phpMyAdmin 是没用的。


















