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 场景下极易出问题：
- 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 可能仍显示旧的服务器名或连错库，原因常是缓存或路径问题：
立即学习“PHP免费学习笔记（深入）”；
- 浏览器缓存了登录页 → 强制刷新（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']，别忘了设它，否则看不出当前连的是哪个环境
