phpmyadmin连不上mysql主因是mysqli扩展未加载或版本不匹配：php 8.1默认不带该扩展，需手动安装php-mysql、确认20-mysqli.ini启用、重启apache，再验证php -m | grep mysqli输出。
PHP 8.1 下 phpMyAdmin 能跑起来，但连不上 MySQL，大概率不是配置写错了，而是 mysqli 扩展压根没加载或版本不匹配。
php -m 里看不到 mysqli 就别调 config.inc.php 了
很多用户卡在登录页报 The mysqli extension is missing，却反复改 config.inc.php 里的 $cfg['Servers'][$i]['host']——这完全无效。PHP 8.1 默认不带 mysqli，得手动装扩展：
- 运行
php -m | grep mysqli，没输出就说明没启用 - 执行
sudo apt install php-mysql（不是php-mysqlnd，后者在 phpMyAdmin 5.2+ 前有兼容问题） - 检查
/etc/php/8.1/apache2/conf.d/20-mysqli.ini是否存在且未被注释；若文件里是;extension=mysqli，删掉分号 -
sudo systemctl restart apache2——注意：用reload不会重载扩展，必须restart
config.inc.php 里 host 和 port 写 localhost 还是 127.0.0.1？
MySQL 默认监听 localhost（Unix socket）和 127.0.0.1（TCP），但行为不同：
- 填
'localhost'：phpMyAdmin 优先走 socket 文件（路径通常为/var/run/mysqld/mysqld.sock），速度快、更安全 - 填
'127.0.0.1'：强制走 TCP，适用于 MySQL 配置了skip-networking=OFF但 socket 路径不对的场景 - 如果遇到
#2002 Cannot log in to the MySQL server，先试127.0.0.1；再查mysql --socket=/var/run/mysqld/mysqld.sock -u root -p能否连通 - 端口不用改，除非你明确改过 MySQL 的
port配置（默认 3306）
Apache 下 Alias /phpmyadmin 不生效？重点看三处
访问 http://localhost/phpmyadmin 返回 404，不是路径错就是模块没挂上：
- 确认
a2enmod php8.1已执行（Ubuntu 22.04+ 默认模块名含版本号，a2enmod php无效） - 检查
/etc/apache2/conf-enabled/phpmyadmin.conf是否真实存在且非空；若缺失，手动创建并确保包含Alias /phpmyadmin /usr/share/phpmyadmin - 确认 Apache 主配置（如
/etc/apache2/apache2.conf）末尾有IncludeOptional conf-enabled/*.conf，否则自定义 conf 文件不会被加载 - Alias 行必须在
<virtualhost></virtualhost>块内，或放在全局配置中——不能塞进.htaccess或子目录配置里
blowfish_secret 空着会怎样？
不设 $cfg['blowfish_secret']，登录页可能显示“服务器错误”或无限跳转回登录页，但不会报具体 PHP 错误：
- 密钥只需 32 字符随机串，比如
$cfg['blowfish_secret'] = 'aB3cD9eF1gH7iJ5kL2mN8oP4qR6sT0uV'; - 这个值只用于 Cookie 加密，和数据库密码无关，但必须存在且长度 ≥32
- 如果从包管理器安装（
apt install phpmyadmin），该字段通常已由 debconf 自动填充；手动解压部署时必须手补 - 改完保存为
config.inc.php，文件权限建议设为644，避免被 Web 可写
最常被忽略的是扩展加载和 Apache 模块启用这两步——它们发生在 PHP 解析 config.inc.php 之前，所以一切配置都得等环境先稳住才起作用。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
