能否在Dockerfile的FROM指令中使用环境变量？如何实现？

问题场景 #

想要无需修改Dockerfile，通过环境变量动态指定FROM指令的基础镜像版本，尝试写法：

FROM php:${PHP_VERSION}-fpm

构建时触发报错：invalid reference format。

可行方案 #

Docker支持在FROM指令中使用动态参数，但不能直接用普通环境变量，需通过**构建参数（build-arg）**实现，步骤如下：

1. 在Dockerfile中用ARG声明参数（可设置默认值），再在FROM中引用：

# 声明构建参数，设置默认版本8.2
ARG PHP_VERSION=8.2
FROM php:${PHP_VERSION}-fpm

2. 构建镜像时，通过--build-arg传递指定的版本值：

# 基于PHP 8.1版本构建
docker build --build-arg PHP_VERSION=8.1 -t my-php-fpm-image .

如果不传递--build-arg参数，Docker会使用ARG声明的默认值（8.2）完成构建。

原写法报错原因 #

FROM指令属于镜像构建的初始阶段，此时普通的ENV环境变量还未被加载生效，必须使用专门的构建参数ARG来传递动态值，才能被FROM指令识别解析。

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