Alpine+phpMyAdmin易报mysqli缺失，因Alpine用musl且PHP官方镜像不预装该扩展；需apk手动安装php82-mysqli等并确认配置在conf.d/zz-docker.ini中。
为什么 Alpine + phpMyAdmin 容易报 mysqli 扩展缺失？
alpine 默认用 musl 而非 glibc，php 官方镜像在 alpine 上不预装 mysqli 或 pdo_mysql —— 不是忘了装，是得手动编译。直接运行会卡在登录页，控制台报 call to undefined function mysqli_connect()。
实操建议：
- 必须显式安装 PHP MySQL 扩展：用
apk add php82-mysqli php82-pdo_mysql（版本号按实际调整） - 确认
extension=mysqli和extension=pdo_mysql出现在/etc/php82/conf.d/zz-docker.ini里（不是php.ini主文件） - 别用
php:alpine基础镜像直接docker exec -it ... php -m验证——容器启动失败时根本进不去，先docker logs看是否加载扩展报错
如何让 phpMyAdmin 正确连接宿主机 MySQL？
在 Alpine 容器里连 host.docker.internal 常失败，不是 DNS 问题，是 Alpine 的 getent hosts 默认不查 Docker 内置 DNS；连 172.17.0.1 也可能被防火墙拦截。
实操建议：
- 启动容器时加
--add-host=host.docker.internal:host-gateway，这是最稳的解法 -
config.inc.php里写死$cfg['Servers'][$i]['host'] = 'host.docker.internal';，别用localhost（它会走 socket，而 Alpine 容器没挂载宿主 socket） - 如果宿主 MySQL 绑定了
127.0.0.1，记得改bind-address = 0.0.0.0并授权'user'@'%'，否则连通但权限拒绝
Dockerfile 构建轻量镜像的关键取舍点
Alpine 镜像小，但 PHP 扩展不是“装上就行”——比如 gd 库缺字体渲染支持，上传图片缩略图会空白；mbstring 缺失则中文库名显示乱码。
实操建议：
- 最小必要扩展组合：除
mysqli/pdo_mysql外，至少加apk add php82-mbstring php82-xml php82-session - 别用
php82-apache，Alpine 没维护好 Apache + PHP 模块加载顺序，改用php82-fpm+ 单独 Nginx 容器更可控 - 把
config.inc.phpCOPY 进镜像前，确保$cfg['blowfish_secret']已填满 32 字符——空值会导致登录页无限重定向
为什么 Alpine 镜像启动后 phpMyAdmin 显示“错误：无法加载 mcrypt 扩展”？
mcrypt 在 PHP 7.2+ 已废弃，Alpine 的现代 PHP 包里根本没这个扩展。报这个错，99% 是你用了老版 phpMyAdmin（如 4.x），它硬依赖 mcrypt，而新版（5.2+）已切到 sodium。
实操建议：
- 直接换
phpmyadmin/phpmyadmin:5.2或更高 tag，别自己拉源码编译旧版 - 检查
Dockerfile是否误写了FROM phpmyadmin/phpmyadmin:4.9—— 这个 tag 在 Alpine 下纯属踩坑 - 如果必须用旧版，只能切到
debian:slim基础镜像，Alpine 上硬凑mcrypt会拖垮构建速度且不稳定
真正麻烦的从来不是“怎么装”，而是 Alpine 下 PHP 扩展的动态链接行为和 Docker 网络模式之间那点微妙的不匹配——多看一眼 docker logs 里的第一行 PHP 模块加载日志，比反复重启容器有用得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
