基于php8.0-apache镜像仅通过Dockerfile安装所需扩展是否可行？

核心结论 #

你猜测的「Dockerfile必须包含完整的原始镜像构建代码」的结论完全错误。
Dockerfile支持分层继承机制，FROM php:8.0-apache 这条指令就已经完整继承了官方php:8.0-apache镜像的所有功能、配置和启动逻辑，你完全不需要重写官方镜像的完整构建代码，只需要在后续叠加自己需要的扩展安装、配置修改等指令即可。

原Dockerfile不生效的原因 #

你编写的最简Dockerfile结构逻辑是成立的，安装失败是因为docker-php-ext-install本质是从源码编译PHP扩展，部分扩展依赖操作系统底层的依赖库，你没有提前安装对应依赖就会导致编译中断，扩展自然不会生效：

• gd扩展依赖libpng、libjpeg等图像处理库
• tidy扩展依赖libtidy-dev库
• zip扩展依赖libzip-dev库

正确实现方案 #

1. 编写Dockerfile（仅需叠加扩展相关逻辑） #

FROM php:8.0-apache

# 安装扩展编译所需的系统依赖，安装完成后清理缓存减小镜像体积
RUN apt-get update && apt-get install -y \
        libpng-dev \
        libjpeg-dev \
        libtidy-dev \
        libzip-dev \
    && rm -rf /var/lib/apt/lists/*

# 按需配置gd扩展编译参数，此处开启jpeg支持
RUN docker-php-ext-configure gd --with-jpeg

# 编译安装所需PHP扩展
RUN docker-php-ext-install mysqli pdo_mysql exif gd tidy zip

2. 配合你熟悉的docker-compose使用 #

无需修改原有compose文件的其他配置，仅需要把原有image: php:8.0-apache的配置替换为build配置，指定Dockerfile的存放路径即可，示例：

version: '3'
services:
  your-web-service:
    build: . # 代表Dockerfile放在当前compose文件的同级目录
    # 你原本配置的ports、volumes、environment等参数全部保留，无需修改
    ports:
      - "80:80"
    volumes:
      - ./your-code:/var/www/html

首次启动或者修改Dockerfile后执行docker-compose up -d --build即可自动构建包含扩展的自定义镜像，后续容器重启不会重复执行安装步骤，完全解决启动脚本重复执行的问题。

扩展安装验证方法 #

容器启动后可执行docker exec 你的容器名 php -m查看已加载的扩展列表，确认需要的扩展是否出现在列表中即可。

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