Laravel 11 不集成 phpMyAdmin，需通过独立容器部署并以服务名（如 db）连接 MySQL；禁止用 localhost 或 --link，必须共用 Docker 网络、配置 PMA_HOST=db、启用 MYSQL_DEFAULT_AUTHENTICATION_PLUGIN=mysql_native_password 兼容认证。
直接说结论：Laravel 11 本身不集成 phpMyAdmin，但你可以在同一 Docker 网络中部署独立的 phpmyadmin 容器，并通过容器名（如 db）连接到 Laravel 的 MySQL 容器——这是最干净、最可控的方式。强行把 phpMyAdmin 打进 Laravel 应用镜像里，既破坏职责分离，又增加安全风险和维护成本。
为什么不能用 --link 或 localhost 连接数据库
在 Laravel 11 的 Docker 环境中，phpmyadmin 容器和 mysql 容器通常处于同一个自定义网络（如 laravel_app_default），此时它们靠服务名通信，而非 localhost。如果你在 phpmyadmin 的启动命令里写 -e PMA_HOST=localhost，它连的是自己容器内部的 loopback，不是 MySQL 容器。
-
PMA_HOST必须设为 MySQL 服务名（例如db），且该名字要和docker-compose.yml中services.db的键名完全一致 - 若使用
--link（已弃用），Docker 会注入/etc/hosts条目，但现代 compose 默认启用用户定义网络，--link不再必要，反而容易混淆 - Windows/macOS 上用 Docker Desktop 时，
host.docker.internal可访问宿主机服务，但不适用于访问同网络其他容器
docker-compose.yml 中如何正确定义 phpMyAdmin 服务
关键点是：与 Laravel 的 mysql 服务共用网络、显式声明依赖、正确传入环境变量。以下是最小可用配置片段：
services:
db:
image: mysql:8.0
environment:
MYSQL_ROOT_PASSWORD: secret
MYSQL_DATABASE: laravel
ports:
- "3306:3306"
volumes:
- mysql_data:/var/lib/mysql
<p>phpmyadmin:
image: xxx.xuanyuan.run/library/phpmyadmin:latest
container_name: phpmyadmin
environment:
PMA_HOST: db # ← 必须和上面 db 的 service 名一致
PMA_PORT: 3306
PMA_ARBITRARY: 1 # 允许手动输入任意服务器地址（调试用，生产建议关）
ports:</p><ul><li>"8081:80"
depends_on:</li><li>db
networks:</li><li>default # 确保和 db 在同一网络</li></ul><p>volumes:
mysql_data:-
PMA_ARBITRARY: 1是调试利器：访问http://localhost:8081后可手动填db:3306登录，避免配置错误导致白屏 - 不要映射
phpmyadmin的/var/www/html/config.inc.php卷来改配置——官方镜像不支持运行时挂载覆盖，改了也无效 - 若 Laravel 项目用了 Redis，
phpmyadmin不需要连它；它只和db通信
Laravel 11 的 .env 和 phpMyAdmin 的权限冲突怎么破
phpMyAdmin 用的是 root 用户连 MySQL，而 Laravel 11 的 .env 里推荐用普通用户（如 DB_USERNAME=laravel）。两者不冲突，但要注意 MySQL 8.0+ 默认认证插件是 caching_sha2_password，root 用户可能无法被 phpMyAdmin 正常识别。
立即学习“PHP免费学习笔记（深入）”；
- 启动
mysql容器时，加环境变量MYSQL_DEFAULT_AUTHENTICATION_PLUGIN=mysql_native_password，否则 phpMyAdmin 会卡在登录页或报#2054 - The server requested authentication method unknown to the client - 或者，在 MySQL 容器内执行：
ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'secret'; FLUSH PRIVILEGES; - Laravel 的
DB_USERNAME和 phpMyAdmin 的登录用户完全独立，别试图让 phpMyAdmin 用laravel用户——它没权限看所有数据库
真正容易被忽略的是网络就绪时机：depends_on 只保证容器启动顺序，不保证 MySQL 已完成初始化。如果 phpMyAdmin 启动太快，会报 mysqli::real_connect(): (HY000/2002): Connection refused。解决办法不是加 sleep，而是用健康检查 + restart_policy，或首次访问时手动重试一次——phpMyAdmin 本身有重连机制，多数情况等几秒刷新即可。
