configure: error: Package requirements (zlib >= 1.2.11) were not met: Package 'zlib' not found

您遇到 configure: error: Package requirements (zlib >= 1.2.11) were not met: Package 'zlib' not found 这个错误，意味着在安装 PHP 的 GD 扩展时，系统缺少了 zlib 开发库。GD 扩展依赖 zlib 来处理压缩数据（例如 PNG 图像）。

当您使用 docker-php-ext-install 来编译和安装 PHP 扩展时，它需要底层的系统开发库。在 Alpine Linux (您的 8.4.7-fpm-alpine 镜像就是基于 Alpine 的) 上，这些开发库通常以 -dev 结尾。

解决方案：

您需要在安装 gd 扩展之前，使用 apk 安装 zlib 的开发包，以及 GD 扩展所需的其他常见依赖，例如 libpng-dev 和 libjpeg-turbo-dev。

这是一个修正后的 Dockerfile 片段：

FROM php:8.4.7-fpm-alpine

# 安装 Composer 所需的系统依赖
RUN apk add --no-cache curl git bash

# 安装 GD 扩展所需的系统依赖
# zlib-dev: 解决了 'Package 'zlib' not found' 错误
# libpng-dev: PNG 图像支持
# libjpeg-turbo-dev: JPEG 图像支持
# freetype-dev: 字体支持 (如果您的 GD 扩展需要处理字体)
# --virtual .build-deps: 用于在安装后清理这些临时的构建依赖
RUN apk add --no-cache --virtual .build-deps \
    zlib-dev \
    libpng-dev \
    libjpeg-turbo-dev \
    freetype-dev \
    && docker-php-ext-configure gd --with-freetype --with-jpeg \
    && docker-php-ext-install -j$(nproc) gd \
    && apk del .build-deps

# 安装 pdo_mysql 扩展 (保持不变，但为了完整性再次列出)
RUN apk add --no-cache --virtual .build-deps-mysql \
    mysql-client-dev \
    && docker-php-ext-install pdo_mysql \
    && apk del .build-deps-mysql

# 下载并安装 Composer
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer

# 验证 Composer、pdo_mysql 和 gd 扩展是否安装成功
RUN composer --version
RUN php -m | grep pdo_mysql
RUN php -m | grep gd

关键更改和解释：

RUN apk add --no-cache --virtual .build-deps ...:
- zlib-dev: 这个是解决您当前错误的关键。它提供了 zlib 的开发文件，gd 扩展编译时需要它们。
- libpng-dev: GD 扩展需要这个来支持 PNG 图像格式。
- libjpeg-turbo-dev: GD 扩展需要这个来支持 JPEG 图像格式。
- freetype-dev: 如果您需要 GD 扩展来处理字体（例如，在图片上绘制文本），那么 freetype-dev 也是必需的。
- --virtual .build-deps: 再次强调，使用虚拟依赖包组可以方便地在安装完成后删除这些只在构建阶段需要的包，从而保持最终镜像的精简。
docker-php-ext-configure gd --with-freetype --with-jpeg:
- 在安装 GD 扩展之前，需要使用 docker-php-ext-configure 来配置它，告诉它使用哪些外部库。
- --with-freetype：指示 GD 使用 FreeType 库进行字体支持。
- --with-jpeg：指示 GD 使用 JPEG 库进行 JPEG 图像支持。
docker-php-ext-install -j$(nproc) gd:
- -j$(nproc)：这是一个优化选项，它会根据 CPU 核数（nproc 命令返回）并行编译，从而加快构建速度。

通过这些修改，gd 扩展应该能够成功编译和安装在您的 8.4.7-fpm-alpine Docker 镜像中。

configure: error: Package requirements (zlib >= 1.2.11) were not met: Package 'zlib' not found

b2tech