必须设置PHPMYADMIN_ARBITRARY=1才能连接Laravel的MySQL容器，因为默认phpmyadmin/phpmyadmin镜像仅允许连接名为mysql或db的服务且禁用任意主机连接，不启用该参数则忽略PHPMYADMIN_HOST等配置。
直接用 phpmyadmin/phpmyadmin 镜像，但必须显式配置 PHPMYADMIN_ARBITRARY=1 才能连上非默认主机（比如你的 Laravel MySQL 容器）。
为什么 phpMyAdmin 连不上 Laravel 的 MySQL 容器？
默认情况下，phpmyadmin/phpmyadmin 只允许连接名为 mysql 或 db 的服务，且只接受固定用户名密码组合。Laravel 项目中 MySQL 服务名常为 mysql、db 或 database，但若没配环境变量，phpMyAdmin 根本不会显示“服务器”下拉框，或登录时提示 #2002 Cannot log in to the MySQL server。
- 根本原因：phpMyAdmin 默认禁用“任意服务器连接”，防止未授权访问
- 关键开关是
PHPMYADMIN_ARBITRARY=1，不加这个，它压根不读你传的PHPMYADMIN_HOST - 即使容器网络互通，没开这个参数，phpMyAdmin 会忽略你指定的 host
docker-compose.yml 中 phpMyAdmin 的最小可用配置
假设你的 Laravel 项目已定义了 mysql 服务（端口 3306，root 密码 password），在 docker-compose.yml 里追加如下服务：
phpmyadmin:
image: phpmyadmin/phpmyadmin
ports:
- "8081:80"
environment:
- PHPMYADMIN_ARBITRARY=1
- PHPMYADMIN_HOST=mysql
- PHPMYADMIN_PORT=3306
- PHPMYADMIN_USER=root
- PHPMYADMIN_PASSWORD=password
depends_on:
- mysql
networks:
- default
-
PHPMYADMIN_HOST必须填 Laravel 的 MySQL 服务名（不是localhost，也不是 IP），Docker 内部靠服务名通信 -
depends_on不保证 MySQL 已 ready，只是启动顺序依赖；首次访问若报错，刷新一次通常就好 - 不要映射
/var/www/html卷——镜像已内置完整 phpMyAdmin，挂载会覆盖
访问时输什么？
浏览器打开 http://localhost:8081 后：
- 如果看到登录页顶部有“服务器”下拉框，说明
PHPMYADMIN_ARBITRARY=1生效了 - 用户名填
root，密码填你mysql服务里设的MYSQL_ROOT_PASSWORD（如password） - 若下拉框为空或只有
localhost，检查是否漏了PHPMYADMIN_ARBITRARY=1，或服务名拼错 - 别点“使用 cookie 登录”——它会尝试存 session 到本地，而容器内默认没配 session 存储路径，容易 500
常见连通性问题排查点
连不上时优先查这三项，比改 Nginx 或 PHP 配置快得多：
- 执行
docker-compose ps确认phpmyadmin和mysql都是Up状态 - 进 phpMyAdmin 容器：
docker exec -it <phpmyadmin-container-name> sh</phpmyadmin-container-name>，然后运行ping mysql——不通就说明网络或服务名有问题 - 检查
mysql服务是否暴露了3306端口（ports:段不是必须的，容器间通信走内部网络，但若你删了ports段，宿主机上的 Navicat 就连不上了）
真正卡住的地方，往往不是 phpMyAdmin 配错了，而是 mysql 服务自己没起来，或者 depends_on 让你误以为它一定 ready 了——MySQL 初始化要几秒，phpMyAdmin 启动更快，早于 MySQL 就会连失败。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
