使用docker-compose部署php:8.1-fpm容器时无法通过apt-get安装php8.1-gmp

问题原因 #

官方php:8.1-fpm镜像中的PHP并非通过Debian系统的apt包管理器安装，而是官方预编译的独立版本。系统仓库中的php8.1-gmp包是为Debian自带的PHP版本提供的，与镜像内的PHP不兼容，因此直接用apt-get install会找不到对应包。

解决方案 #

方案1：修改docker-compose.yml中的command指令 #

使用官方镜像提供的docker-php-ext-install工具安装gmp扩展，同时需先安装依赖库libgmp-dev，并在安装完成后启动php-fpm（否则容器会执行完命令就退出）：

修改后的docker-compose.yml片段：

version: '3'
services:
  php:
    image: php:8.1-fpm
    depends_on:
      - mysql
    command: bash -c "apt-get update && apt-get install -y libgmp-dev && docker-php-ext-install gmp && php-fpm"
    volumes:
      - ./:/var/www/html:rw,cached
  # 其他服务配置不变

方案2：构建自定义Dockerfile（推荐） #

每次启动容器都重新安装扩展效率低，推荐编写Dockerfile构建自定义镜像：

1. 在项目根目录创建Dockerfile：

FROM php:8.1-fpm

# 安装依赖并编译gmp扩展
RUN apt-get update && apt-get install -y --no-install-recommends libgmp-dev \
    && docker-php-ext-install gmp \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

2. 修改docker-compose.yml中的php服务，替换image为build：

version: '3'
services:
  php:
    build: . # 使用当前目录的Dockerfile构建镜像
    depends_on:
      - mysql
    volumes:
      - ./:/var/www/html:rw,cached
  # 其他服务配置不变

3. 执行docker-compose up --build启动服务，首次会构建自定义镜像，后续启动直接复用。

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