基于Debian构建PHP项目Docker镜像时遇libwebp依赖缺失错误求助

错误信息 #

checking for libwebp >= 0.2.0... no
configure: error: Package requirements (libwebp >= 0.2.0) were not met:

No package 'libwebp' found

解决方案 #

Debian镜像默认未安装libwebp的开发依赖，PHP编译相关扩展（比如GD）时需要该库的头文件和开发文件，你需要在Dockerfile中添加安装libwebp-dev包的步骤：

• 在Dockerfile的RUN指令里，先更新apt源，再安装libwebp-dev：

RUN apt-get update && apt-get install -y \
    libwebp-dev \
    # 可追加其他所需依赖，比如libpng-dev、libjpeg-dev等
    && rm -rf /var/lib/apt/lists/*

• 如果是编译GD扩展，需确保配置时指定启用webp支持：

RUN docker-php-ext-configure gd --with-webp --with-jpeg \
    && docker-php-ext-install gd

完整示例片段 #

FROM debian:bookworm

# 安装基础依赖与libwebp开发包
RUN apt-get update && apt-get install -y \
    curl \
    libwebp-dev \
    libpng-dev \
    libjpeg-dev \
    && rm -rf /var/lib/apt/lists/*

# 安装PHP及带webp支持的GD扩展
RUN curl -sSL https://packages.sury.org/php/README.txt | bash - && \
    apt-get update && apt-get install -y php8.2 php8.2-gd && \
    docker-php-ext-configure gd --with-webp --with-jpeg && \
    docker-php-ext-install gd

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