引言
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官方提供了一种优雅且健壮的多主机配置方案，它通过循环遍历一个主机列表来动态生成服务器配置。这种方法确保了每个服务器都被正确地分配了独立的配置索引，并且易于扩展和维护。
HR面试评价助手-Word版
下载
🎯 HR面试评价助手（Word版格式） 生成可直接复制到Word文档的标准格式HR面试评价 【使用方式】 1. 发送口令：HR面试评价 2. 粘贴JD文字 3. 上传简历文档 4. 上传面试记录（可选） 5. 复制生成的评价到Word 【输出特点】 - 纯文本格式，可直接粘贴到Word - 层次清晰，标题加粗...
通常，您可以在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中管理多个数据库服务器。这种方法不仅解决了登录界面不显示所有服务器的问题，还提高了配置的可读性和可维护性。遵循本教程的指导，您将能够轻松地在不同数据库环境之间切换，从而极大地提升您的数据库管理体验。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
