如何隐藏SQL密码实现本地Docker与Heroku平台的跨环境数据库连接适配

核心问题根因 #

现有connect.php强制加载本地config.php的逻辑没有做环境分支判断，部署到Heroku时如果本地config.php被带入运行环境，代码会跳过平台环境变量读取流程，直接用本地的数据库参数发起连接，最终连接失败。

connect.php 具体改造步骤 #

• 调整参数读取优先级：按照平台环境变量 > 本地config.php配置的顺序获取数据库连接参数，不再强制加载本地配置文件
• 增加Heroku数据库连接串自动解析逻辑：兼容Heroku MySQL插件（如JawsDB、ClearDB）自动注入的完整连接URL，自动拆分为连接需要的四个字段，不需要手动在Heroku Config Vars中拆分配置参数
• 增加文件存在性判断：仅当本地config.php文件真实存在、且环境变量没有读到数据库参数时，才加载该文件补全配置，从逻辑上隔离生产环境的加载流程

改造后核心代码参考 #

<?php
// 初始化数据库配置空值
$dbConfig = [
    'host' => '',
    'user' => '',
    'pass' => '',
    'dbname' => ''
];

// 1. 优先读取Heroku平台自动注入的数据库连接串
$herokuDbConnStr = getenv('JAWSDB_URL') ?: getenv('CLEARDB_DATABASE_URL');
if ($herokuDbConnStr) {
    $connParts = parse_url($herokuDbConnStr);
    $dbConfig['host'] = $connParts['host'];
    $dbConfig['user'] = $connParts['user'];
    $dbConfig['pass'] = $connParts['pass'];
    $dbConfig['dbname'] = ltrim($connParts['path'], '/');
}

// 2. 环境变量未获取到配置时，才加载本地Docker环境用的config.php
if (empty($dbConfig['host']) && file_exists(__DIR__ . '/config.php')) {
    require __DIR__ . '/config.php';
    $dbConfig['host'] = $dbConfig['host'] ?: MYSQL_SERVER;
    $dbConfig['user'] = $dbConfig['user'] ?: MYSQL_USER;
    $dbConfig['pass'] = $dbConfig['pass'] ?: MYSQL_PASS;
    $dbConfig['dbname'] = $dbConfig['dbname'] ?: MYSQL_DBNAME;
}

// 3. 统一实例化mysqli连接并校验状态
$conn = new mysqli(
    $dbConfig['host'],
    $dbConfig['user'],
    $dbConfig['pass'],
    $dbConfig['dbname']
);
if ($conn->connect_error) {
    die("数据库连接异常: " . $conn->connect_error);
}
?>

配套落地注意事项 #

• 本地Docker环境无需修改原有config.php的定义和Docker的挂载配置，改造后的代码会自动识别本地文件并加载，完全兼容原有本地运行逻辑
• 将本地config.php加入项目的.gitignore文件，避免本地数据库的敏感配置被提交到远程仓库，从根源上杜绝Heroku运行环境中存在本地config.php的可能
• 如果Heroku侧没有使用官方MySQL插件，而是手动配置了MYSQL_SERVER、MYSQL_USER等独立Config Vars，代码会通过getenv自动识别这些参数，不需要额外调整解析逻辑
• 上线前可在Heroku控制台临时打印getenv的返回值，确认平台侧的数据库参数能被PHP正常读取，避免连接参数名不匹配的问题

内容的提问来源于stack exchange，提问作者mavethee