TYPO3 8.7：将FAL UID转换为图片路径问题求助

Hey there, let's sort out this image display issue you're hitting post-upgrade. The root problem is that TYPO3 completely changed how file references work for fe_users between 6.2 and 8.7—your old code is still relying on the legacy uploads/pics path pattern, which doesn't play nice with the modern file reference system introduced in newer versions.

Why This Happens #

In TYPO3 6.2, the fe_users.image field likely stored a raw file ID or relative path under uploads/pics/. But by 8.7, this field is almost certainly configured as a File Reference (linked to sys_file_reference), meaning feUser.image now returns a collection of file reference objects—not just a simple ID or string. Your current code is trying to treat that object like a raw ID/path, hence the broken display.

The Fix: Update Your Fluid Code #

Here's how to adjust your template to work with TYPO3 8.7's file reference system:

<f:for each="{feUsers}" as="feUser" key="number" iteration="itemIteration">
  <div class="feuser">
    <f:if condition="{feUser.image}">
      <!-- Grab the first file reference if multiple images are allowed -->
      <f:image 
        src="{feUser.image.0}" 
        title="{feUser.name}" 
        alt="{feUser.name}" 
        maxWidth="159" 
        maxHeight="220" 
        width="159c" 
        height="220c" 
        crop="true" 
        cropVariant="default" 
      />
    </f:if>
  </div>
</f:for>

Key Changes Explained: #

1. Removed uploads/pics/{feUser.image}: File references in 8.7 contain all necessary metadata to locate the file—you don't need to hardcode the legacy path anymore.
2. Removed treatIdAsReference="1": This attribute is only for raw file IDs from sys_file, but feUser.image.0 is already a file reference object, so the ViewHelper handles it automatically.
3. Added .0 to feUser.image: If your fe_users.image field allows multiple images, it returns an array of references. Using .0 ensures you grab the first image (adjust this if you need to loop through multiple images).

Additional Checks to Ensure Everything Works: #

• Verify TCA Configuration: Make sure your fe_users TCA for the image field is correctly set up for file references. Add this to your extension's Configuration/TCA/Overrides/fe_users.php if it's missing:

  $GLOBALS['TCA']['fe_users']['columns']['image'] = [
    'label' => 'LLL:EXT:core/Resources/Private/Language/locallang_general.xlf:LGL.images',
    'config' => [
      'type' => 'inline',
      'foreign_table' => 'sys_file_reference',
      'foreign_field' => 'uid_foreign',
      'foreign_table_field' => 'tablenames',
      'foreign_match_fields' => [
        'fieldname' => 'image',
      ],
      'foreign_sortby' => 'sorting_foreign',
      'foreign_label' => 'uid_local',
      'foreign_selector' => 'uid_local',
      'overrideChildTca' => [
        'columns' => [
          'uid_local' => [
            'config' => [
              'appearance' => [
                'elementBrowserType' => 'file',
                'elementBrowserAllowed' => 'gif,jpg,jpeg,png',
              ],
            ],
          ],
        ],
        'types' => [
          \TYPO3\CMS\Core\Resource\File::FILETYPE_IMAGE => [
            'showitem' => '
              --palette--;;imageoverlayPalette,
              --palette--;;filePalette
            ',
          ],
        ],
      ],
      'minitems' => 0,
      'maxitems' => 1, // Adjust if you allow multiple images
    ],
  ];
  

• Check Existing fe_users Records: Ensure images in your fe_users records are properly linked (not just orphaned IDs). Verify this in the TYPO3 backend by editing a fe_user record and checking the image field.
• Clear All Caches: TYPO3 caches a lot of metadata—clear frontend, backend, and configuration caches to make sure your changes take effect.

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