如何通过phpMyAdmin配置文件实现生产与测试环境的快速切换？-phpMyAdmin-PHP中文网

phpmyadmin不支持多环境配置文件，正确做法是在config.inc.php中通过getenv()读取phpmyadmin_env等环境变量，动态构造$cfg'servers'数组，按环境加载对应host/user/password等参数，避免硬编码、文件替换和敏感信息泄露。

不能靠改同一个 config.inc.php 文件来回切换环境 —— 这会导致配置混杂、部署出错、敏感信息泄露。 正确做法是让 phpmyadmin 启动时「自动加载对应环境的配置」，核心靠 $cfg['servers'] 数组动态构造 + 环境变量驱动。

用环境变量控制 `$cfg['Servers']` 加载逻辑

phpMyAdmin 本身不原生支持多环境配置文件，但允许你在 config.inc.php 中写 PHP 逻辑。关键是在加载服务器列表前，先读取环境变量，再决定用哪套连接参数。

在 Web 服务器（如 Nginx/Apache）中设置环境变量：fastcgi_param PHPMYADMIN_ENV "production";（Nginx）或 SetEnv PHPMYADMIN_ENV testing（Apache）

在 config.inc.php 开头加入判断逻辑，避免硬编码覆盖：

$env = getenv('PHPMYADMIN_ENV') ?: 'development';
$servers = [
    'development' => [
        'host' => 'localhost',
        'user' => 'dev_user',
        'password' => 'dev_pass',
        'auth_type' => 'config',
    ],
    'testing' => [
        'host' => 'test-db.example.com',
        'user' => 'test_user',
        'password' => getenv('TEST_DB_PASSWORD'), // 从系统变量读，不写死
        'auth_type' => 'config',
    ],
    'production' => [
        'host' => 'prod-db.example.com',
        'user' => 'prod_ro_user',
        'password' => getenv('PROD_DB_PASSWORD'),
        'auth_type' => 'config',
        'AllowRoot' => false,
    ],
];
$i = 0;
$i++;
$cfg['Servers'][$i] = $servers[$env];

这样每次请求进来，$cfg['Servers'][1] 就是当前环境对应的数据库连接，无需改文件、无需重启服务

为什么不能直接复制 config.inc.php 并手动替换？

常见错误是建 config.production.php 和 config.testing.php，然后部署时靠脚本 mv 替换 —— 这在容器或 CI/CD 场景下极易出问题：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

Git 提交了带密码的 config 文件 → 安全漏洞
忘记清理临时 config → 下次启动加载错环境
多个 phpMyAdmin 实例共享同一份 config 目录 → 互相覆盖
config.inc.php 里还有其他非数据库配置（如 $cfg['blowfish_secret']），不同环境混用可能引发加密失败或登录异常

如何安全注入数据库密码等敏感值？

绝不能把密码写进 config.inc.php 或提交到 Git。必须通过运行时注入：

生产环境：由容器编排工具（如 Docker/K8s）或部署脚本注入系统环境变量，例如 PROD_DB_PASSWORD=xxx
测试环境：用 systemd 的 EnvironmentFile= 或 Nginx 的 env 指令加载外部密钥文件
本地开发：可配合 vlucas/phpdotenv，但在 config.inc.php 中需手动加载（phpMyAdmin 不自动支持 Dotenv）：
```
if (file_exists(__DIR__ . '/.env')) {
    $dotenv = new Dotenv\Dotenv(__DIR__);
    $dotenv->load();
}
```
注意：getenv() 在某些 PHP SAPI（如 Apache prefork）下默认不可用，需确认 variables_order 包含 E，或改用 $_SERVER['PHPMYADMIN_ENV']

切换后验证是否生效？

最容易被忽略的是：改完配置后，phpMyAdmin 可能仍显示旧的服务器名或连错库，原因常是缓存或路径问题：

浏览器缓存了登录页 → 强制刷新（Ctrl+Shift+R）或检查 Network 标签页看 index.php 响应头中的 X-PMA-Server 是否匹配预期
phpMyAdmin 加载了多个 config.inc.php → 检查 phpinfo() 中 include_path 和实际使用的配置文件路径（echo __FILE__; 放在 config 开头）
连接成功但权限不对 → 查看 $cfg['Servers'][$i]['AllowRoot'] 和 'AllowNoPassword' 是否按环境关闭了高危选项
页面左上角显示的服务器名来自 $cfg['Servers'][$i]['verbose']，别忘了设它，否则看不出当前连的是哪个环境