TYPO3 12 LTS Fluid模板获取父页面首张资源图片URL

针对你遇到的页面媒体字段仅返回关联计数、无法直接获取图片URL的问题，以下是三种通用可行的解决方案：

方案1：原生TypoScript+Fluid组合（推荐，兼容性强） #

Fluid模板代码 #

{f:cObject(
    typoscriptObjectPath: 'lib.pageFileUrl',
    data: {pageUid: data.pid, field: 'media'}
)}

对应TypoScript配置（写入setup.typoscript） #

lib.pageFileUrl = TEXT
lib.pageFileUrl {
    data = page:{field}:0 // 0表示取字段关联的首个文件引用
    stdWrap.cObject = FILES
    stdWrap.cObject {
        references {
            table = pages
            uid.data = page:{pageUid}
            fieldName = {field}
        }
        renderObj = TEXT
        renderObj {
            data = file:current:publicUrl
        }
    }
}

通用化说明：需要获取其他字段（如og_image）时，只需修改Fluid中field参数的值即可。

方案2：正确使用VHS ViewHelper #

之前的错误是未指定返回类型，导致仅拿到关联计数。调整后的代码：

{v:page.resources(
    uid: data.pid,
    field: 'media',
    returnType: 'references' // 强制返回SysFileReference对象数组
) -> v:iterator.first() -> v:variable.set(name: 'targetImage')}

<f:if condition="{targetImage}">
    {f:uri.image(src: targetImage)}
</f:if>

关键：returnType: 'references'是核心，确保返回的是可被f:uri.image识别的文件引用对象，而非数字计数。

方案3：直接访问已加载的页面数据（依赖上下文） #

如果父页面数据已被加载到模板上下文（比如通过自定义控制器扩展），可直接调用：

<f:if condition="{parentPage.media.0}">
    {f:uri.image(src: parentPage.media.0)}
</f:if>

局限性：仅适用于父页面数据已在当前模板上下文可用的场景，通用性稍弱。

核心原理说明 #

TYPO3页面的媒体类字段（如media、og_image）存储的是关联文件引用的数量，而非文件/引用的UID，因此必须通过关联关系查询获取实际的SysFileReference对象，才能正常生成图片URL。

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