本教程旨在解决phpMyAdmin登录界面无法显示多个数据库服务器选项的问题。通过详细解析config.inc.php配置文件，我们将演示如何采用官方推荐的多主机配置方法，利用循环结构定义多个数据库连接，确保所有服务器都能在phpMyAdmin登录时正常显示并可供选择，从而提升数据库管理效率。
引言
phpmyadmin是广泛使用的mysql/mariadb数据库管理工具。在日常开发和运维中，我们常常需要管理多个数据库服务器，例如本地开发环境的数据库、docker容器中的数据库以及远程生产环境的数据库。然而，许多用户在尝试配置多个服务器时，会遇到phpmyadmin登录界面只显示一个服务器，或者配置不生效的问题。这通常是由于config.inc.php配置文件中的服务器定义方式不正确导致的。
本文将深入探讨phpMyAdmin多服务器配置的正确方法，基于官方推荐的配置模式，指导您如何有效地管理多个数据库连接。
常见配置误区与问题分析
用户在配置多个服务器时，通常会尝试手动递增$i变量来定义$cfg[‘Servers’][$i]，或者将服务器配置放置在不恰当的条件语句中。例如，以下是常见的错误尝试：
// 错误的配置尝试示例if (!empty($dbname)) { $cfg['Servers'][$i]['host'] = 'localhost'; // ... 其他配置 $i++; // 在条件块内递增，可能导致第二个服务器无法被正确识别}// 第二个服务器的配置// $i++; // 如果这里再次递增，可能导致跳过索引$cfg['Servers'][$i]['host'] = '172.18.0.1:3307';// ... 其他配置
这种配置方式的问题在于：
$i变量的生命周期和作用域：如果在条件语句或特定逻辑块中递增$i，可能导致其值在后续的全局配置中不连续或不符合预期。配置覆盖或跳过：不正确的$i管理可能导致phpMyAdmin只识别到第一个或最后一个定义的服务器，或者出现空白页面，因为配置数组的索引被错误地处理了。缺乏统一管理：当服务器数量增多时，这种手动维护的方式变得繁琐且容易出错。
正确配置多服务器的方法
phpMyAdmin官方提供了一种优雅且健壮的多主机配置方案，它通过循环遍历一个主机列表来动态生成服务器配置。这种方法确保了每个服务器都被正确地分配了独立的配置索引，并且易于扩展和维护。
立即学习“PHP免费学习笔记（深入）”；
通常，您可以在phpMyAdmin的安装目录（例如/etc/phpmyadmin/或phpmyadmin/libraries/）找到名为config.inc.php的主配置文件。请编辑此文件。
示例配置代码
以下是基于官方推荐模式的config.inc.php多服务器配置示例：
<?php/* * Generated by phpMyAdmin * all config for servers */declare(strict_types=1);// 确保服务器索引从1开始，phpMyAdmin不使用$cfg['Servers'][0]$i = 0;// 定义所有需要管理的数据库主机列表// 格式为 '主机名:端口' 或 '主机名'$hosts = [ 'localhost', // 本地MySQL服务器 '172.18.0.1:3307', // Docker容器或其他远程MySQL服务器 // 更多服务器可以在这里添加 // 'remote.database.com:3306',];// 遍历主机列表，为每个主机配置phpMyAdmin服务器连接foreach ($hosts as $host) { $i++; // 每次循环递增服务器索引，确保从1开始且连续 // 基本连接参数 $cfg['Servers'][$i]['host'] = $host; $cfg['Servers'][$i]['port'] = ''; // 如果主机名已包含端口，此处留空 $cfg['Servers'][$i]['socket'] = ''; $cfg['Servers'][$i]['connect_type'] = 'tcp'; // 连接类型，通常为tcp $cfg['Servers'][$i]['extension'] = 'mysqli'; // 推荐使用mysqli扩展 $cfg['Servers'][$i]['compress'] = false; // 是否启用压缩 // 认证方式和用户凭据 $cfg['Servers'][$i]['auth_type'] = 'cookie'; // 推荐使用cookie认证，安全性高 // 如果使用'config'认证类型，则需在此处直接指定用户和密码 // $cfg['Servers'][$i]['auth_type'] = 'config'; // $cfg['Servers'][$i]['user'] = 'your_username'; // $cfg['Servers'][$i]['password'] = 'your_password'; // 可选：为每个服务器设置一个易于识别的别名 $cfg['Servers'][$i]['verbose'] = ($host === 'localhost') ? '本地开发数据库' : 'Docker容器数据库'; // phpMyAdmin高级功能所需的控制用户和数据库 // 这些是phpMyAdmin内部用于存储书签、关系等功能的，需要一个专门的用户和数据库。 // 如果您不使用这些高级功能，可以留空或注释掉。 $cfg['Servers'][$i]['controluser'] = 'pma'; // 控制用户，需在MySQL中创建 $cfg['Servers'][$i]['controlpass'] = 'pmapass'; // 控制用户密码 // phpMyAdmin控制数据库名称 $cfg['Servers'][$i]['pmadb'] = 'phpmyadmin'; $cfg['Servers'][$i]['bookmarktable'] = 'pma__bookmark'; $cfg['Servers'][$i]['relation'] = 'pma__relation'; $cfg['Servers'][$i]['table_info'] = 'pma__table_info'; $cfg['Servers'][$i]['table_coords'] = 'pma__table_coords'; $cfg['Servers'][$i]['pdf_pages'] = 'pma__pdf_pages'; $cfg['Servers'][$i]['column_info'] = 'pma__column_info'; $cfg['Servers'][$i]['history'] = 'pma__history'; $cfg['Servers'][$i]['table_uiprefs'] = 'pma__table_uiprefs'; $cfg['Servers'][$i]['tracking'] = 'pma__tracking'; $cfg['Servers'][$i]['userconfig'] = 'pma__userconfig'; $cfg['Servers'][$i]['recent'] = 'pma__recent'; $cfg['Servers'][$i]['favorite'] = 'pma__favorite'; $cfg['Servers'][$i]['users'] = 'pma__users'; $cfg['Servers'][$i]['usergroups'] = 'pma__usergroups'; $cfg['Servers'][$i]['navigationhiding'] = 'pma__navigationhiding'; $cfg['Servers'][$i]['savedsearches'] = 'pma__savedsearches'; $cfg['Servers'][$i]['central_columns'] = 'pma__central_columns'; $cfg['Servers'][$i]['designer_settings'] = 'pma__designer_settings'; $cfg['Servers'][$i]['export_templates'] = 'pma__export_templates'; // 其他可选配置 $cfg['Servers'][$i]['only_db'] = ''; // 限制此服务器只显示特定数据库 // $cfg['Servers'][$i]['AllowNoPassword'] = true; // 允许无密码登录，极不推荐在生产环境使用}
配置详解
$i = 0;: 初始化服务器索引计数器。phpMyAdmin的服务器数组$cfg[‘Servers’]从索引1开始。$hosts = […]: 定义一个包含所有数据库主机地址的数组。每个元素可以是’主机名’或’主机名:端口’的形式。foreach ($hosts as $host): 遍历$hosts数组。在每次循环中：$i++;: 递增$i，确保为每个服务器分配一个唯一的、从1开始的连续索引。$cfg[‘Servers’][$i][‘host’] = $host;: 设置当前服务器的主机地址。$cfg[‘Servers’][$i][‘port’] = ”;: 如果主机名中已包含端口（如172.18.0.1:3307），则此处留空；否则，如果端口不是默认的3306，需要在此处明确指定。$cfg[‘Servers’][$i][‘connect_type’] = ‘tcp’;: 指定连接类型，通常为TCP/IP。$cfg[‘Servers’][$i][‘extension’] = ‘mysqli’;: 推荐使用mysqli扩展以获得更好的性能和安全性。$cfg[‘Servers’][$i][‘auth_type’] = ‘cookie’;: 强烈推荐使用cookie认证。这意味着每次登录时用户都需要输入用户名和密码。config认证类型：如果您选择’config’认证（如原问题中的第二个服务器），则必须在配置中直接提供$cfg[‘Servers’][$i][‘user’]和$cfg[‘Servers’][$i][‘password’]。这种方式将凭据硬编码到配置文件中，安全性较低，尤其不适用于生产环境。$cfg[‘Servers’][$i][‘verbose’]: 为每个服务器设置一个易于识别的别名，它将显示在phpMyAdmin登录界面的下拉菜单中。$cfg[‘Servers’][$i][‘controluser’] / $cfg[‘Servers’][$i][‘controlpass’] / $cfg[‘Servers’][$i][‘pmadb’]: 这些是phpMyAdmin高级功能（如书签、关系图等）所需的配置。您需要在MySQL中创建一个名为pma（或您指定的其他名称）的用户，并授予其对phpmyadmin（或您指定的其他名称）数据库的必要权限。如果不需要这些高级功能，可以不配置。
注意事项
配置文件位置：config.inc.php通常位于phpMyAdmin的安装目录或/etc/phpmyadmin/。请确保您修改的是正确的配置文件。权限问题：确保Web服务器用户（如www-data或apache）对config.inc.php文件具有读取权限。Web服务器重启：修改config.inc.php后，有时需要重启Web服务器（如Apache或Nginx）以及PHP-FPM服务，以确保配置生效。安全性：始终优先使用cookie认证类型。避免在生产环境中使用config认证类型，因为它将数据库凭据明文存储在配置文件中。为controluser设置强密码，并限制其权限仅限于phpmyadmin控制数据库。Valet等开发环境：如果您使用Valet或其他本地开发工具，phpMyAdmin的访问地址可能会从localhost/phpmyadmin变为phpmyadmin.test等自定义域名。这不会影响多服务器的配置逻辑，但请确保您是通过正确的URL访问phpMyAdmin。端口与主机名：当主机名包含端口时（如172.18.0.1:3307），$cfg[‘Servers’][$i][‘port’]可以留空。如果主机名不包含端口，且端口不是默认的3306，则必须显式设置$cfg[‘Servers’][$i][‘port’]。
总结
通过采用上述基于foreach循环的配置方法，您可以清晰、高效地在phpMyAdmin中管理多个数据库服务器。这种方法不仅解决了登录界面不显示所有服务器的问题，还提高了配置的可读性和可维护性。遵循本教程的指导，您将能够轻松地在不同数据库环境之间切换，从而极大地提升您的数据库管理体验。
以上就是phpMyAdmin多服务器配置详解：解决登录界面不显示多个数据库连接问题的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1292854.html
微信扫一扫 
支付宝扫一扫 
