无需构建传参：Docker Compose中.env变量传入Dockerfile的方法

问题分析 #

你遇到的报错翻译为：

构建失败：rpc错误：代码=未知描述=使用前端dockerfile.v0构建失败：无法创建LLB定义：解析阶段名称"php:"失败：无效的引用格式

出现该错误的核心原因有两点：

1. .env文件格式错误：你使用了YAML风格的KEY: VALUE格式，但.env文件要求是Shell风格的KEY=VALUE，docker-compose无法正确识别这种格式的变量，导致PHP_VERSION为空值。
2. 对environment段的作用误解：docker-compose中的environment是给容器运行时设置环境变量的，和镜像构建阶段完全无关，所以Dockerfile在构建时根本读不到这个变量，才会出现php:这种空引用的无效格式错误。

解决方法 #

方法一：修正.env格式+自动传递构建参数（无需命令行额外加参数） #

虽然你提到不想用构建参数，但其实可以让docker-compose自动从.env读取参数，完全不用在docker-compose build后手动加参数，完全符合你的需求：

1. 修正.env文件为Shell格式：

PHP_VERSION=8.0.30-fpm-bullseye

2. 修改Dockerfile，添加ARG接收构建参数（这是Docker构建阶段读取外部变量的标准方式，无需手动传参）：

ARG PHP_VERSION
FROM php:${PHP_VERSION}
# do stuff

3. 修改docker-compose.yaml，配置build段自动从.env读取参数：

services:
  your-service-name:
    build:
      context: .
      args:
        PHP_VERSION: ${PHP_VERSION} # 自动加载.env中的变量

执行docker-compose build时，docker-compose会自动读取.env里的PHP_VERSION并传递给Dockerfile，全程不用在命令行加任何参数。

方法二：完全不用ARG的另类方案（不推荐） #

如果坚持完全不用ARG，可以利用docker-compose的变量替换功能，动态生成构建用的Dockerfile内容：

1. 同样先修正.env文件格式。
2. 修改docker-compose.yaml（需docker-compose 1.28+版本支持）：

services:
  your-service-name:
    build:
      context: .
      dockerfile_inline: |
        FROM php:${PHP_VERSION}
        # do stuff

这种方式相当于让docker-compose动态生成带变量替换的Dockerfile后再构建，不需要修改原Dockerfile，但不利于Dockerfile的单独维护，因此更推荐方法一。

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