怎么在Laragon中添加phpMyAdmin_本地集成环境扩展-phpMyAdmin-PHP中文网

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> ... 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 的域名，必须手动干预配置，但改动点很集中：

修改 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 即可