Apple Silicon(M1)环境Docker构建PHP项目报错：无效包名docker-php-ext-configure

核心原因 #

Apple Silicon采用ARM64架构，你之前的构建配置是针对Intel x86架构的，导致部分PHP扩展（如imagick）没有适配ARM64的预编译包，同时官方镜像提供的docker-php-ext-configure脚本在架构不匹配场景下出现调用错误。

具体修复方案 #

1. 替换为ARM兼容的PHP基础镜像 #

使用官方已适配ARM64的PHP镜像版本，比如带bullseye或bookworm后缀的镜像：

# 替换成你项目需要的PHP版本，示例为PHP7.4
FROM php:7.4-fpm-bookworm

2. 手动编译安装imagick #

PECL暂无ARM64预编译imagick包，需先安装编译依赖再手动编译：

# 安装imagick编译依赖并编译安装
RUN apt-get update && apt-get install -y \
    libmagickwand-dev --no-install-recommends \
    && pecl install imagick \
    && docker-php-ext-enable imagick \
    && apt-get clean && rm -rf /var/lib/apt/lists/*

如果直接pecl install imagick报错，可指定兼容ARM的具体版本：

RUN pecl install imagick-3.7.0

3. 修正docker-php-ext-configure调用错误 #

docker-php-ext-configure是官方PHP镜像内置的配置脚本，不是可安装的包。安装其他扩展时按正确格式调用：

# 示例：安装gd扩展的正确配置方式
RUN docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) gd

4. 强制以x86模式运行（可选） #

若部分依赖无ARM版本，可在docker-compose.yaml中指定平台兼容x86（会有性能损耗）：

services:
  php:
    build: .
    platform: linux/amd64
    # 其他原有配置...

验证步骤 #

1. 清理旧镜像和缓存：docker system prune -a
2. 重新执行构建：docker-compose up --build -d

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