现象
后台上传 WebP 图片后需要生成缩略图,imagick 读取时抛 ImagickException: no decode delegate for this image format `WEBP',同一台机器上转 JPG、PNG 都正常。命令行 convert 处理 WebP 也报同样错误,说明问题不在 PHP 代码。
原因
ImageMagick 对每种格式的支持来自编译时的 delegate 库,PHP 的 imagick 扩展只是一层封装。系统里装了 ImageMagick,但编译时没有链接 libwebp,就不具备 WebP 编解码能力。policy.XML 也可能禁用 WebP,或机器上存在两个版本,命令行和扩展链接的不是同一个。
解决步骤
第一步,确认 delegate 是否存在。列出支持的格式,看 WEBP 后面是 rw 还是空白,同时确认 convert 路径。
convert -version
which convert
convert -list format | grep -i webp
第二步,补 libwebp 并重装。装开发包后重装发行版 ImageMagick,再重装 imagick 扩展,让它链接新库。只装 libwebp 运行包不行,编译需要头文件。
sudo apt install -y libwebp-dev imagemagick
sudo pecl uninstall imagick
sudo pecl install imagick
sudo systemctl restart php8.3-fpm
第三步,检查策略和白名单。打开 /etc/ImageMagick-7/policy.xml,确认没有禁用 WEBP;如果用 cwebp 命令行方案,路径要和 PHP 进程的 PATH 一致。
验证
convert -list format 里 WEBP 显示 rw,PHP 中 Imagick::queryFormats('WEBP') 返回非空数组,读取并另存一张 WebP 图片成功,异常不再出现。
小结
这类报错要区分是 PHP 扩展问题还是 ImageMagick 本身缺 delegate。先用 convert 命令验证,再补库重装,最后检查 policy。
