通过Docker环境变量配置config.php连接MySQL及协作部署疑问

嘿，作为Docker新手，你的思路完全没问题——用环境变量代替硬编码是最佳实践之一，我来一步步给你捋清楚：

一、在Docker里定义环境变量的几种方式 #

1. 使用docker-compose.yml直接定义 #

如果用docker-compose管理容器，你可以直接在文件里指定环境变量，或者引用.env文件里的值：

version: '3.8'
services:
  your-php-app:
    build: .
    environment:
      - DB_SERVER=mysql-container  # 同一compose网络里填MySQL服务名即可
      - DB_USERNAME=db_user
      - DB_PASSWORD=db_pass
      # 也可以引用.env文件变量，写法是 ${变量名}
      # - DB_SERVER=${DB_SERVER}
      # - DB_USERNAME=${DB_USERNAME}
      # - DB_PASSWORD=${DB_PASSWORD}
    depends_on:
      - mysql
  mysql:
    image: mysql:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=root_pass
      - MYSQL_DATABASE=your_target_db
      - MYSQL_USER=db_user
      - MYSQL_PASSWORD=db_pass

2. 使用.env文件（推荐） #

创建一个.env文件放在docker-compose.yml同目录下，把敏感变量存这里，一定要把.env加入.gitignore，绝对别提交到GitHub！

# .env文件内容
DB_SERVER=mysql-container
DB_USERNAME=db_user
DB_PASSWORD=your_secure_password_here

然后docker-compose.yml里就可以直接引用这些变量，像上面注释的那样，这样既方便管理，又能避免敏感信息泄露。

3. 在Dockerfile里定义（不推荐存敏感信息） #

如果是单个Dockerfile，也可以用ENV指令，但这种方式会把变量值打包进镜像里，密码这类敏感信息千万别这么用：

FROM php:7.4-apache
# 非敏感变量可以这么设置，比如默认的数据库地址
ENV DB_SERVER=mysql

二、确保config.php能正确读取环境变量 #

你的代码片段已经用了getenv()，这没问题，不过可以加个默认值或者错误处理，避免变量没设置时报错：

<?php
// config.php
define('DB_SERVER', getenv('DB_SERVER') ?: 'localhost'); // 没拿到变量就用localhost当默认值
define('DB_USERNAME', getenv('DB_USERNAME') ?: 'root');
define('DB_PASSWORD', getenv('DB_PASSWORD') ?: '');

// 数据库连接示例
$conn = mysqli_connect(DB_SERVER, DB_USERNAME, DB_PASSWORD);
if (!$conn) {
    die("连接失败: " . mysqli_connect_error());
}
?>

三、你的疑问解答：别人克隆后需要自己设置环境变量吗？ #

是的！ 因为你不会把包含敏感信息的.env文件提交到GitHub（这是安全红线），所以别人克隆你的仓库后：

• 可以参考你提供的.env.example文件（你可以把这个示例文件提交到GitHub，里面只放变量名和占位值），复制一份改名为.env后填入自己的数据库信息
• 或者在运行容器时通过命令行直接指定环境变量，比如：

docker run -e DB_SERVER=mysql -e DB_USERNAME=db_user -e DB_PASSWORD=your_pass your-image-name

新手小贴士 #

• 永远不要把包含密码、密钥的.env文件提交到版本控制，这是安全大忌！
• 用docker-compose时，运行容器它会自动读取同目录的.env文件，不用额外指定参数
• 测试环境变量是否生效，可以在PHP代码里加var_dump(getenv('DB_USERNAME'));看看能不能拿到正确的值

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