远程服务器php-imagick下ImageMagick转SVG为PNG忽略样式表输出黑图

• 业务流程：基于php-imagick扩展加载SVG模板，通过DOM注入自定义值后渲染为PNG格式图片
• 本地开发环境下全流程运行正常
• 远程服务器异常表现：生成的PNG大多为黑色，流程无任何错误抛出，ImageMagick无法识别SVG内嵌style块中声明的类样式并应用
• 服务器基础环境：Debian GNU/Linux 9.9 (stretch)、PHP7.3、nginx/1.10.3
• 版本信息疑惑：PHPInfo显示imagick模块版本为3.4.4，标注发布时间为2017年；本地环境同基础版本带git提交后缀（3.4.4.r66.g448c1cd），发布时间为2021年1月30日，无法确认服务器端运行的是否为最新版本。已知模块版本标注与官方发布时间存在差异。
• 已完成的排查操作：
  • 最初php-imagick无法识别SVG文件类型，安装libmagickcore-6.q16-3-extra包并重载PHP、Nginx服务后，可正常生成PNG，但所有样式表定义的样式均未生效
  • 尝试将style标签从defs标签内部移到外部，样式仍无法生效
  • 曾考虑将SVG解析委托切换为Inkscape，但未找到php-imagick下切换委托的配置方法，认为该方案复杂度较高

核心原因定位 #

Debian 9默认通过libmagickcore-6.q16-3-extra安装的SVG解析后端为旧版rsvg-convert，该版本对SVG内嵌<style>块中的CSS类选择器存在已知兼容缺陷，会直接忽略所有类选择器定义的样式规则。由于解析器不会读取style块中的类规则，遇到带类名的SVG元素时会使用默认的黑色填充值，最终导致全图大面积变黑。本地环境如果使用较新版本的解析后端，不会触发该兼容问题。

可落地的解决路径 #

• 先验证解析后端类型
  在服务器命令行执行convert -list delegate | grep svg，查看SVG格式对应的委托程序。如果输出指向rsvg-convert，即可确认是上述兼容问题导致的样式丢失。
• 低侵入修复方案（无需修改服务器软件源）
  在PHP端处理SVG模板时，完成DOM值注入后，遍历SVG的style块提取所有类定义规则，通过DOM查询匹配对应类名的元素，将规则中的fill、stroke、font等属性直接写入元素的内联属性中。该方案利用旧版解析器可正常识别元素内联属性的特性，完全绕开解析器对类选择器的支持缺陷，不需要调整服务器环境，修改完成即可直接生效，开发量较小。
• 环境升级修复方案
  升级服务器上的librsvg2组件至2.40.20以上版本，新版本已修复内嵌style块的CSS解析兼容问题，不需要修改现有业务代码即可让原有SVG模板正常渲染。
• 版本疑问澄清
  PHPInfo中显示的3.4.4是php-imagick扩展的版本号，并非ImageMagick核心库的版本号。3.4.4为扩展的正式发布版本，发布时间确实为2017年；带git提交后缀的版本是正式版基础上的开发分支快照，不属于正式发布版本。ImageMagick核心库的版本可通过执行convert -version命令查看，与php-imagick扩展版本相互独立。
• Inkscape委托配置方法
  如需将SVG解析后端切换为Inkscape，仅需完成两个配置步骤，不需要修改php-imagick扩展的任何代码：
  • 在服务器上安装Inkscape软件包
  • 修改ImageMagick的delegates.xml配置文件（默认路径为/etc/ImageMagick-6/delegates.xml），将SVG格式对应的委托路径调整为Inkscape可执行文件路径，重载PHP-FPM服务后即可生效。

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