Laragon 自带 phpMyAdmin，需通过 Quick Add 启用并配置域名映射（如 phpmyadmin.test），确保 hosts 文件正确、Apache 虚拟主机自动生成、PHP 扩展齐全，避免手动修改配置导致 404 或 500 错误。
phpMyAdmin 在 Laragon 中默认已存在，但需手动启用
很多人以为要“添加” phpmyadmin，其实 laragon 从 4.x 开始就自带 phpmyadmin，只是没开放访问入口。它默认放在 laragonetcppsphpmyadmin 目录下，不启动服务、不配虚拟主机，就打不开 http://phpmyadmin.test。
关键动作是启用内置服务 + 配置域名映射：
- 打开 Laragon 主界面 → 点击右上角
Menu→Quick Add→ 勾选phpMyAdmin（不是“安装”，是“启用”） - 确保
phpmyadmin.test已写入系统hosts文件（Laragon 通常自动处理，但有时会失败；可手动检查C:WindowsSystem32driversetchosts是否含127.0.0.1 phpmyadmin.test） - 重启 Laragon（不是重载，是彻底退出再启动），否则新配置不生效
访问时提示 “The requested URL was not found”
这是最常见报错，本质是 Apache/Nginx 没把请求路由到 phpMyAdmin 的物理路径。Laragon 默认用 Apache，其虚拟主机配置在 Laragonusrlocalpache2confextrahttpd-vhosts.conf，但你**不该手动改这个文件**——Laragon 的 Quick Add 会自动生成正确配置。
出问题的典型原因：
-
phpMyAdmin被勾选后，Laragon 没生成对应 vhost 条目（常见于权限不足或杀毒软件拦截写入）→ 查看httpd-vhosts.conf末尾是否有类似<VirtualHost *:80> ... DocumentRoot "Laragonetcppsphpmyadmin" ...</VirtualHost> - PHP 版本切换后，
phpMyAdmin的config.inc.php中的$cfg['Servers'][$i]['auth_type']若设为cookie，而 PHP 缺少mbstring或openssl扩展 → 访问直接 500；检查phpinfo()页面确认扩展已加载 - 浏览器缓存了旧的 404 响应 → 强制刷新（
Ctrl+F5）或换隐身窗口测试
想换端口或改域名（比如用 phpmyadmin.local）
Laragon 不支持在 UI 里直接改 phpMyAdmin 的域名，必须手动干预配置，但改动点很集中：
立即学习“PHP免费学习笔记（深入）”；
- 修改
Laragonetcppsphpmyadminconfig.inc.php：找到$cfg['Servers'][$i]['host'] = 'localhost';，确保它没被改成其他 IP（尤其别写成127.0.0.1:3307这类带端口的） - 编辑
Laragonusrlocalpache2confextrahttpd-vhosts.conf，把ServerName phpmyadmin.test改成ServerName phpmyadmin.local - 同步更新系统
hosts文件，把127.0.0.1 phpmyadmin.local加进去 - 重启 Apache（Laragon 右键菜单 →
Apache > Restart），不要只重启整个 Laragon
注意：phpmyadmin.local 这类无 TLD 的域名在新版 Chrome/Firefox 会被拦截（要求必须带点），建议坚持用 .test 或 .localhost。
升级 phpMyAdmin 后登录页空白或报错
Laragon 自带的 phpMyAdmin 是精简版（去除了部分语言包和主题），手动替换完整版 zip 很容易翻车。核心风险点：
- 新版 phpMyAdmin（5.2+）强制要求 PHP ≥ 7.4，且依赖
zip扩展 → 检查php -m | findstr zip是否输出zip - 复制文件时漏掉
vendor/目录（Composer 依赖）→ 直接白屏，错误日志在Laragonlogspacheerror.log里能看到Class 'Psr\Log\LoggerInterface' not found -
config.inc.php被覆盖 → 登录后进不了数据库，因为$cfg['Servers'][$i]['auth_type']变回config（明文存密码），而$cfg['Servers'][$i]['password']为空 → 改回cookie即可
真正省事的做法：等 Laragon 官方更新内置版本，或者用 Quick Add 卸载再重装，别手抖覆盖整个目录。
