TYPO3 11：如何用sys_file_reference扩展视频海报字段？

你当前的核心问题是TCA配置逻辑搞反了：你要给sys_file_reference本身扩展poster字段，却在某个主表中把poster定义成了关联sys_file_reference的inline类型，导致前端只能返回关联状态的0/1值，而非实际的文件对象。

修正步骤 #

1. 调整TCA配置位置与内容 #

你需要在sys_file_reference的TCA中直接添加poster字段，而非在主表中创建关联。创建/修改文件Configuration/TCA/Overrides/sys_file_reference.php：

<?php
defined('TYPO3') or die();

// 为sys_file_reference添加poster字段
$GLOBALS['TCA']['sys_file_reference']['columns']['poster'] = [
    'exclude' => true,
    'label' => '视频海报',
    'config' => [
        'type' => 'inline',
        'foreign_table' => 'sys_file',
        'foreign_field' => 'uid_foreign',
        'foreign_table_field' => 'tablenames',
        'foreign_match_fields' => [
            'fieldname' => 'poster',
        ],
        'minitems' => 0,
        'maxitems' => 1,
        'appearance' => [
            'elementBrowserEnabled' => true,
            'fileUploadAllowed' => true,
            'headerThumbnail' => [
                'field' => 'uid_local',
                'height' => 45 // 修正之前的无效值'45m'
            ]
        ],
        'overrideChildTca' => [
            'columns' => [
                'uid_local' => [
                    'config' => [
                        'appearance' => [
                            'elementBrowserType' => 'file',
                            'elementBrowserAllowed' => 'jpg,jpeg,png'
                        ]
                    ]
                ]
            ]
        ]
    ]
];

// 将poster字段添加到sys_file_reference的表单显示中
\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addToAllTCAtypes(
    'sys_file_reference',
    'poster',
    'video', // 仅针对视频类型的文件引用显示该字段，留空则全部显示
    'after:description' // 字段显示位置
);

2. 修复原配置中的低级错误 #

你之前的TCA存在几个语法错误，会导致配置失效：

• foreign_sortby 、useSortable 、headerThumbnail 字段名后多了空格，需删除
• headerThumbnail中的height值'45m'无效，改为数字45

3. 确保模型与SQL配置正确 #

• SQL表扩展：sys_file_reference的poster字段需为INT类型，关联sys_file.uid，示例SQL：

  ALTER TABLE sys_file_reference ADD COLUMN poster INT(11) DEFAULT '0' NOT NULL;
  

• FileReference模型：确保属性注解与getter/setter正确，示例：

  /**
   * @var \TYPO3\CMS\Extbase\Domain\Model\File|null
   */
  protected ?File $poster = null;
  
  /**
   * @return \TYPO3\CMS\Extbase\Domain\Model\File|null
   */
  public function getPoster(): ?File
  {
      return $this->poster;
  }
  
  /**
   * @param \TYPO3\CMS\Extbase\Domain\Model\File|null $poster
   */
  public function setPoster(?File $poster): void
  {
      $this->poster = $poster;
  }
  

4. 前端获取数据 #

修正后，在Fluid模板中可直接通过视频的文件引用对象获取海报文件：

{# 假设fileReference是视频的sys_file_reference对象 #}
<f:if condition="{fileReference.poster}">
    <img src="{fileReference.poster.publicUrl}" alt="视频海报">
</f:if>

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