Docker镜像启动脚本内变量解析与默认值配置-Docker-PHP中文网

Docker启动脚本需严谨处理环境变量，默认值回退用${VAR:-default}，空值/空白需trim校验，未定义、显式为空、含空白均应覆盖，并支持运行时覆盖优先级。

docker镜像启动脚本内变量解析与默认值配置

在 Docker 镜像的启动脚本（如 entrypoint.sh 或 startup.sh）中，合理解析环境变量并设置默认值，是保障容器健壮运行的关键。这类脚本通常依赖 $ENV_VAR 获取配置，但若变量未传入或为空，直接使用会导致启动失败或行为异常。

变量是否为空的判断逻辑要严谨

Docker 启动时通过 -e VAR=value 或 environment: 传入变量，但以下情况都需覆盖：

变量完全未定义：$VAR 展开为空字符串，[ -z "$VAR" ] 为真
变量显式设为空：如 -e DB_HOST=，此时 $DB_HOST 是空字符串，同样触发 -z
变量含空白字符：如 -e LOG_LEVEL=" "，-z 仍为真，但可能需 trim 处理

推荐用 ${VAR:-default} 进行简单默认值回退；对需校验/清理的场景，建议先赋值再判断：

DB_HOST=${DB_HOST:-"localhost"}
DB_PORT=${DB_PORT:-5432}
# 若允许空值但需非空才生效，可加条件检查
if [ -n "$DB_HOST" ]; then
  echo "Connecting to $DB_HOST:$DB_PORT"
else
  echo "DB_HOST not set, skipping connection"
fi

支持运行时覆盖的变量优先级设计

常见需求是：镜像内置默认值 .env 文件

先读取 /etc/default/app 或 /app/config.env（如有，用 set -a; source ...; set +a 导出）
再用 ${VAR:-${DEFAULT_VAR}} 形式兜底，避免覆盖已定义变量
关键配置（如密码、密钥）不设默认值，改用 ${VAR:?Error: VAR is required} 强制校验

数值与布尔型变量的安全转换

环境变量本质是字符串，直接用于判断易出错：

端口/数字类：用 [[ "$PORT" =~ ^[0-9]+$ ]] && PORT=${PORT:-8080} 校验格式
布尔类：统一约定 ENABLE_CACHE=true/false/1/0/yes/no，转为小写后匹配：

enable_cache=$(echo "${ENABLE_CACHE:-false}" | tr '[:upper:]' '[:lower:]')
if [[ "$enable_cache" =~ ^(1|true|yes)$ ]]; then
  CACHE_ENABLED=1
else
  CACHE_ENABLED=0
fi