TYPO3 v12.4中plan2net/webp转WebP插件无法工作求助

问题背景 #

基于Composer的TYPO3 v12.4本地环境（无法升级到v13），安装plan2net/webp插件后，无法生成图片的WebP副本，已执行以下操作但无效果：

已尝试的操作 #

• 将WebP添加到允许的文件格式：

  $GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext'] .= ',webp';
  

• 通过Composer安装插件：

  ddev composer require "plan2net/webp"
  

• 在后端确认插件已安装且状态稳定
• 刷新TYPO3和PHP缓存，在维护模块清除处理过的文件，更新数据库结构
• 在.htaccess中添加WebP重写规则（已启用mod_rewrite.c）：

  <IfModule mod_rewrite.c>
   RewriteEngine On
   RewriteCond %{HTTP_ACCEPT} image/webp
   RewriteCond %{REQUEST_FILENAME} (.*)\.(png|gif|jpe?g)$
   RewriteCond %{REQUEST_FILENAME}\.webp -f
   RewriteRule ^ %{REQUEST_FILENAME}\.webp [L,T=image/webp]
  </IfModule>
  

• 在.htaccess末尾添加Vary头部规则：

  <IfModule mod_headers.c>
      <FilesMatch "\.(png|gif|jpe?g)$">
          Header append Vary Accept
      </FilesMatch>
  </IfModule>
  

• 再次刷新缓存并清除处理过的文件

还需排查的遗漏点 #

1. 检查PHP扩展的WebP支持 #

确认PHP安装的图片处理扩展（GD或Imagick）支持WebP：

• 执行命令ddev exec php -i | grep webp查看是否有WebP相关输出
• 若使用GD：确保GD编译时包含WebP支持；若使用Imagick：确认Imagick版本支持WebP格式

2. 验证GFX处理器配置 #

检查TYPO3的图片处理器设置：

• 确认$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor']设置为ImageMagick或GD（均需支持WebP）
• 若用ImageMagick，验证处理器路径正确，且执行ddev exec convert -list format | grep WEBP能看到WebP格式支持

3. 检查插件的具体配置 #

进入TYPO3后端「扩展>配置」，找到plan2net/webp的设置：

• 确认已启用「自动生成WebP」选项
• 检查转换规则是否包含所有需要处理的图片格式（jpg、png、gif等）
• 验证质量参数设置合理，避免因参数错误导致转换失败

4. 查看系统错误日志 #

• 到TYPO3后端「系统>日志」模块，搜索与图片转换、webp插件相关的错误信息（如权限不足、处理器执行失败）
• 检查ddev容器日志或PHP错误日志，排查底层执行报错

5. 确认文件目录权限 #

• 确保fileadmin/_processed_目录及子目录有写入权限，web服务器用户（如www-data）能在此创建文件
• 执行ddev exec ls -l fileadmin/_processed_查看权限配置

6. 手动触发图片处理 #

• 编辑后端的一张图片并保存，观察是否生成WebP副本
• 执行命令ddev typo3 image:process手动触发图片处理，查看命令行输出的错误信息

内容的提问来源于stack exchange，提问作者Loreen T.