You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Docker环境下PHP 8-fpm的GD扩展不支持WebP格式问题排查

问题根因

当前Docker配置存在两处核心缺失,直接导致GD扩展无法支持WebP格式:

  • 未安装WebP处理对应的系统依赖库libwebp-dev,编译GD扩展时没有可调用的底层WebP编解码能力
  • 编译GD扩展前未显式指定开启WebP支持的编译参数,官方php:8-fpm镜像默认编译GD时不会自动启用WebP适配
修复方法

调整Dockerfile中依赖安装、GD扩展编译的相关段落,修改后的对应配置如下:

# Install system dependencies
RUN apt-get update && apt-get install -y \
    git \
    curl \
    libpng-dev \
    libonig-dev \
    libxml2-dev \
    libwebp-dev \
    libjpeg-dev \
    libfreetype6-dev \
    zip \
    unzip \
    pngquant

# Clear cache
RUN apt-get clean && rm -rf /var/lib/apt/lists/*

# 配置GD扩展编译参数,显式开启WebP等格式支持
RUN docker-php-ext-configure gd \
    --with-webp \
    --with-jpeg \
    --with-freetype

# Install PHP extensions
RUN docker-php-ext-install pdo_mysql mbstring exif pcntl bcmath gd
有效性验证

重新构建镜像后,进入容器执行命令php -r 'var_dump(gd_info());',返回结果中WebP Support项值为bool(true)即代表配置生效。

构建时如果存在旧镜像缓存,需要添加--no-cache参数执行构建,避免缓存导致修改未被应用。

内容的提问来源于stack exchange,提问作者Kos-Mos

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.29 01:54:33