TYPO3 glossary2扩展Extbase多文件上传仅显示单个文件的问题

在TYPO3 11.5.19 + Glossary2 5.0.9环境下，为Glossary模型扩展多文件上传字段download，后端可添加多个文件，但前端通过f:debug仅显示单个FileReference实例，无法获取所有上传文件的集合。

问题根源 #

你的Domain Model中download属性定义为单个FileReference对象，而TCA配置允许最多5个文件上传，Extbase无法将多个文件关联到单个对象属性，因此只会返回最后一个关联的文件。

解决方案 #

1. 修改Domain Model代码

将download属性改为ObjectStorage<FileReference>类型，并添加对应的集合操作方法：

<?php

declare(strict_types=1);

namespace SM\SmGlossary\Domain\Model;

use TYPO3\CMS\Extbase\Domain\Model\FileReference;
use TYPO3\CMS\Extbase\Persistence\ObjectStorage;

/**
 * Glossary
 */
class Glossary extends \JWeiland\Glossary2\Domain\Model\Glossary
{
    /**
     * Download files
     *
     * @var ObjectStorage<FileReference>
     * @TYPO3\CMS\Extbase\Annotation\ORM\Cascade("remove")
     */
    protected $download;

    /**
     * Initialize object
     */
    public function initializeObject()
    {
        $this->download = new ObjectStorage();
    }

    /**
     * Returns the download files
     *
     * @return ObjectStorage<FileReference>
     */
    public function getDownload()
    {
        return $this->download;
    }

    /**
     * Sets the download files
     *
     * @param ObjectStorage<FileReference> $download
     * @return void
     */
    public function setDownload(ObjectStorage $download)
    {
        $this->download = $download;
    }

    /**
     * Adds a download file
     *
     * @param FileReference $download
     * @return void
     */
    public function addDownload(FileReference $download)
    {
        $this->download->attach($download);
    }

    /**
     * Removes a download file
     *
     * @param FileReference $download
     * @return void
     */
    public function removeDownload(FileReference $download)
    {
        $this->download->detach($download);
    }
}

2. 确认TCA配置（现有配置已满足，可跳过）

确保TCA中maxitems设置为大于1的值（你的配置已设为5），且foreign_sortby正确配置以支持文件排序：

'maxitems' => 5,
'foreign_sortby' => 'sorting_foreign',

3. 清除缓存并更新代理类

在TYPO3后端执行以下操作：

• 清除所有缓存（系统 > 维护 > 清除缓存）
• 重新生成Extbase代理类（系统 > 设置 > 配置 > Extbase > 清除代理类并重新生成）

验证修改 #

前端使用f:debug输出glossary.download时，将显示ObjectStorage实例，包含所有上传的FileReference对象。可通过循环遍历获取每个文件：

<f:for each="{glossary.download}" as="file">
    <a href="{f:uri.image(image: file, treatIdAsReference: 1)}">{file.originalResource.name}</a>
</f:for>

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