phpMyAdmin不支持为前端用户绑定TLS客户端证书,仅支持为后端数据库连接配置客户端证书;需在$cfg['Servers'][$i]中显式设置ssl、ssl_ca、ssl_cert、ssl_key、ssl_mode全部五项,缺一即退化为非加密连接。

phpMyAdmin 本身不支持为用户绑定 TLS 客户端证书
phpMyAdmin 是一个 Web 界面代理,它用 PHP 连接 MySQL/MariaDB,不提供「让用户上传或选择客户端证书」的功能。所谓“为用户绑定 TLS 证书”,实际是指:让 phpMyAdmin **以特定用户身份、携带指定客户端证书**去连接后端数据库。这完全由 $cfg['Servers'][$i] 的 SSL 配置控制,和 phpMyAdmin 前端的登录用户(如 root、appuser)无关。
换句话说:你配置的是「phpMyAdmin 连数据库时用哪套证书」,不是「登录 phpMyAdmin 的人用什么证书」。后者属于 Web 层 HTTPS 认证(如 Apache 的 SSLVerifyClient),和数据库加密无关。
必须显式配置全套 ssl_* 键,缺一不可
在 config.inc.php 中,每个服务器定义(如 $cfg['Servers'][1])若要启用客户端证书认证(即双向 TLS),需同时设置以下五项:
-
$cfg['Servers'][$i]['ssl'] = true—— 布尔值,不能是"true"或1 -
$cfg['Servers'][$i]['ssl_ca']—— CA 证书绝对路径,如/etc/pma/certs/rds-shanghai.pem -
$cfg['Servers'][$i]['ssl_cert']—— 客户端证书绝对路径,如/etc/pma/certs/client-cert.pem -
$cfg['Servers'][$i]['ssl_key']—— 对应私钥绝对路径,权限必须为600,属主为运行 PHP 的用户(如www-data或apache) -
$cfg['Servers'][$i]['ssl_mode']—— 推荐VERIFY_IDENTITY(云数据库必需),不是REQUIRED
漏掉任意一项(比如只设了 ssl 和 ssl_ca,但没写 ssl_cert),phpMyAdmin 就会静默退化为非加密连接,且不报错、不提示。
立即学习“PHP免费学习笔记(深入)”;
MySQL 服务端必须允许并验证客户端证书
仅 phpMyAdmin 配了证书不够,MySQL 侧也得配合:
- 服务端
my.cnf中已正确配置ssl-ca、ssl-cert、ssl-key,且have_ssl = YES - 创建用户时明确要求客户端证书:
CREATE USER 'pma-client'@'%' REQUIRE X509;或更细粒度地限定:REQUIRE SUBJECT '/CN=pma-client' AND ISSUER '/CN=MyInternalCA' - 确认该用户连接时实际走加密:登录后执行
SHOW STATUS LIKE 'Ssl_cipher';,返回非空值才算成功
常见失败点:MySQL 报 Access denied for user ... (using password: YES),其实不是密码错,而是服务端拒绝了未带有效证书的连接——此时要检查 REQUIRE X509 是否生效,以及 phpMyAdmin 配置中证书路径是否可被 PHP 进程读取(比如 SELinux 拦截、路径拼错、权限不对)。
云数据库实例 CA 证书不可混用
如果你连的是阿里云 RDS、腾讯云 CDB 等,它们提供的 CA 证书是实例级的,带唯一指纹。把 A 实例下载的 rds-ca-2023.pem 直接用于 B 实例,OpenSSL 校验会失败,报错类似:
mysqli::real_connect(): SSL connection error: unknown ca<br>mysqli::real_connect(): SSL connection error: unable to get local issuer certificate
解决方法:
- 每个云实例单独下载其控制台提供的 CA 证书,存为不同文件名(如
/etc/pma/certs/rds-prod.pem、/etc/pma/certs/rds-staging.pem) - 在对应
$cfg['Servers'][$i]中,ssl_ca必须指向该实例专属路径 - 用
openssl x509 -in /path/to/cert.pem -text -noout | grep "Subject:"确认证书 Subject 是否含该实例地域/ID 信息
最容易被忽略的是:phpMyAdmin 的 SSL 配置是 per-server、per-connection 的,没有继承机制;哪怕你只改了一个键,整个 TLS 握手逻辑就变了。调试时别只看界面是否打开,务必查 Ssl_cipher 和错误日志。



















