Docker环境下如何正确为PHP中的ImageMagick开启WebP支持？

问题描述 #

我在Dockerfile中做了如下配置：

FROM urre/wordpress-nginx-docker-compose-image
# ... 其他各类配置 ...
RUN apt-get update \
&& apt-get -y --no-install-recommends install \
webp \
imagemagick \
libmagickwand-dev \
libwebp-dev

容器能正常运行，但执行phpinfo()后发现WebP并未出现在支持的图像格式列表中。尝试了多种方法都无效，请问如何在Docker中正确配置？

我之前碰到过一模一样的问题——你已经搞定了系统级的WebP依赖，但PHP的图像扩展（GD或者Imagick）没启用WebP支持，这才是核心问题。给你几个一步步能落地的解决办法：

1. 确保PHP GD扩展支持WebP #

大部分预构建的PHP镜像里，GD扩展默认可能没编译WebP支持。既然你的镜像用的是Debian/Ubuntu体系（从apt-get能看出来），可以直接安装带WebP支持的php-gd包，然后重启PHP-FPM让扩展生效：

# 把这段加到你现有的RUN安装依赖的命令后面
RUN apt-get install -y php-gd \
&& service php-fpm restart

如果你的PHP是源码编译的，那得在编译GD的时候加上--with-webp参数，但对于WordPress这类预构建镜像，用包管理器装现成的扩展肯定更省心。

2. 配置Imagick扩展支持WebP（如果用Imagick处理图片） #

要是你打算用Imagick来处理WebP，光装系统级的imagemagick和libmagickwand-dev不够，还得装PHP的Imagick扩展，并且确保它能识别WebP：

# 安装PHP Imagick扩展，注意替换成你实际的PHP版本（比如7.4/8.0）
RUN pecl install imagick \
&& echo "extension=imagick.so" > /etc/php/7.4/mods-available/imagick.ini \
&& ln -s /etc/php/7.4/mods-available/imagick.ini /etc/php/7.4/fpm/conf.d/20-imagick.ini \
&& service php-fpm restart

装完后可以用这条命令验证：php -r "print_r(Imagick::queryFormats('WEBP'));"，如果输出包含WebP相关格式，就说明生效了。

3. 验证配置是否成功 #

重新构建镜像、启动容器后，你可以用两种方式确认：

• 打开phpinfo()页面，找到GD扩展的板块，查看*WebP support*项是否显示enabled
• 在容器命令行执行php -r "var_dump(gd_info()['WebP Support']);"，返回bool(true)就说明配置没问题

额外小贴士 #

有些WordPress专用镜像可能有自己的扩展管理方式，比如自带脚本或者用wp-cli，你也可以看看镜像的官方文档有没有推荐的扩展安装路径。另外，一定要记得安装扩展后重启PHP-FPM，不然新扩展不会被加载哦。

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