phpMyAdmin多服务器配置教程：解决连接显示问题

文章不知道大家是否熟悉？今天我将给大家介绍《phpMyAdmin多服务器配置教程：解决连接显示问题》，这篇文章主要会讲到等等知识点，如果你在看完本篇文章后，有更好的建议或者发现哪里有问题，希望大家都能积极评论指出，谢谢！希望我们能一起加油进步！

本教程旨在解决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';
// ... 其他配置

这种配置方式的问题在于：

1. $i变量的生命周期和作用域：如果在条件语句或特定逻辑块中递增$i，可能导致其值在后续的全局配置中不连续或不符合预期。
2. 配置覆盖或跳过：不正确的$i管理可能导致phpMyAdmin只识别到第一个或最后一个定义的服务器，或者出现空白页面，因为配置数组的索引被错误地处理了。
3. 缺乏统一管理：当服务器数量增多时，这种手动维护的方式变得繁琐且容易出错。

正确配置多服务器的方法

phpMyAdmin官方提供了一种优雅且健壮的多主机配置方案，它通过循环遍历一个主机列表来动态生成服务器配置。这种方法确保了每个服务器都被正确地分配了独立的配置索引，并且易于扩展和维护。

通常，您可以在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; // 允许无密码登录，极不推荐在生产环境使用
}

配置详解

1. $i = 0;: 初始化服务器索引计数器。phpMyAdmin的服务器数组$cfg['Servers']从索引1开始。
2. $hosts = [...]: 定义一个包含所有数据库主机地址的数组。每个元素可以是'主机名'或'主机名:端口'的形式。
3. 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多服务器配置教程：解决连接显示问题》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于的内容请关注golang学习网公众号！