如何在Symfony的Twig模板中渲染Contentful富文本内的图片资源

• 手动注册EmbeddedImage渲染器到富文本渲染器集合
  官方默认提供的基础渲染器集合没有内置嵌入式图片的渲染逻辑，你需要在实例化渲染器时主动添加该渲染器：

use Contentful\RichText\Renderer;
use Contentful\RichText\NodeRenderer\EmbeddedImage;
use Contentful\RichText\NodeRenderer\Paragraph;
use Contentful\RichText\NodeRenderer\Text;

$renderer = new Renderer();
// 先添加你用到的基础文本、段落等渲染器
$renderer->pushNodeRenderer(new Paragraph());
$renderer->pushNodeRenderer(new Text());
// 关键步骤：添加嵌入式图片渲染器
$renderer->pushNodeRenderer(new EmbeddedImage());

• Symfony依赖注入场景下手动加标签
  如果你用Symfony的自动装配机制，需要在services.yaml中给EmbeddedImage类添加对应标签，才能被Contentful渲染器自动识别：

services:
    Contentful\RichText\NodeRenderer\EmbeddedImage:
        tags: ['contentful.rich_text.node_renderer']

• 确认查询时开启资源关联解析
  调用Contentful接口查询富文本内容时，要设置include参数值至少为2，确保关联的图片资源会被嵌套返回，而不是仅返回资源引用ID，否则渲染器无法拿到图片URL完成渲染。
• 检查渲染器优先级
  如果自定义了其他节点渲染器，要确保EmbeddedImage渲染器的优先级高于通用节点渲染器，避免图片节点被其他渲染器提前处理导致渲染失效。

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