怎么使用 environment 指令在 Docker Compose 中动态注入环境变量教程-Docker-PHP中文网

docker compose 的 environment 指令本身不支持动态注入，需结合 .env 文件、shell 环境变量或 env_file 实现：.env 提供默认值，shell 变量可覆盖它，env_file 适合管理敏感信息，三者可协同使用。

怎么使用 environment 指令在 docker compose 中动态注入环境变量教程

在 Docker Compose 中，environment 指令本身不支持“动态注入”——它只是静态设置容器启动时的环境变量。真正实现动态注入的关键在于结合外部机制：比如 Shell 环境变量、.env 文件、或运行时命令行传参。下面分场景讲清楚怎么用 environment 配合这些方式灵活传入变量。

使用 .env 文件预设默认值

Docker Compose 默认会读取项目根目录下的 .env 文件（无需显式声明），里面定义的变量可在 docker-compose.yml 中通过 ${VAR_NAME} 引用。这是最常用、最干净的动态基础。

示例：

根目录下创建 .env：

DB_HOST=postgres
DB_PORT=5432
APP_ENV=staging

在 docker-compose.yml 中使用：

services:
  web:
    image: myapp:latest
    environment:
      - DATABASE_URL=postgresql://${DB_HOST}:${DB_PORT}/mydb
      - APP_ENV=${APP_ENV}

⚠️ 注意：.env 文件只影响 Compose 解析 YAML 的过程，不会自动注入到容器内部；要进容器，还得靠 environment 或 env_file 显式传递。

用 environment + 变量展开实现运行时覆盖

如果本地 Shell 已设置了同名变量，它会自动覆盖 .env 中的值（优先级：Shell > .env > YAML 字面量）。

Docker Desktop

Docker Desktop 可用于构建容器化 PHP 开发环境，适合 Laravel、Symfony、WordPress 等项目统一运行依赖。

下载

比如在终端执行：

DB_HOST=localhost APP_ENV=local docker-compose up -d

此时 web 容器中 DB_HOST 和 APP_ENV 就会取 Shell 传入的值，而不是 .env 里的。

这种写法适合 CI/CD 或临时调试，无需改文件就能切换配置。

用 env_file 加载外部环境文件（推荐用于敏感变量）

当变量较多、或含密码等敏感信息时，建议用 env_file 单独管理，并配合 environment 有选择地导入：

新建 prod.env：

POSTGRES_PASSWORD=secret123
REDIS_URL=redis://cache:6379

在 docker-compose.yml 中引用：

services:
  api:
    image: myapi:latest
    env_file:
      - prod.env
    environment:
      - LOG_LEVEL=info
      - TZ=Asia/Shanghai

这样 POSTGRES_PASSWORD 和 REDIS_URL 会从文件加载并注入容器，而 LOG_LEVEL 和 TZ 由 YAML 直接指定。

✅ 优势：env_file 支持多文件、可 gitignore、与 environment 共存互补。

避免常见陷阱

不要在 environment 中写未定义变量：如 - DB_URL=${MISSING_VAR}，Compose 会留空字符串，容易导致应用启动失败，建议加默认值 ${MISSING_VAR:-localhost}；
变量名区分大小写，且不能含点号或连字符（如 API-KEY 不合法）；
environment 下的 - KEY=VALUE 格式会覆盖 env_file 中同名项，后定义的优先；
想让容器内也读取宿主机的 $HOME、$PWD？得用 - KEY=$HOST_VAR 写法（注意是 $，不是 ${}）。