Fluid模板自定义ConditionViewHelper缓存异常问题求助

问题根源：TYPO3页面缓存会将Fluid渲染结果整体存储，你的InListViewHelper输出未与当前页面ID绑定，导致所有页面复用首次加载的缓存结果。以下是两种无需使用<f:cache.disable>的解决方案：

方案1：让ViewHelper支持缓存变体 #

修改自定义ViewHelper类，实现CacheableInterface并添加页面ID作为缓存变体标识，让TYPO3为不同页面生成独立缓存条目。

<?php
namespace YourVendor\YourExtension\ViewHelpers;

use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Fluid\Core\ViewHelper\AbstractViewHelper;
use TYPO3\CMS\Fluid\Core\ViewHelper\CacheableInterface;

class InListViewHelper extends AbstractViewHelper implements CacheableInterface
{
    public function initializeArguments()
    {
        parent::initializeArguments();
        $this->registerArgument('list', 'string', '逗号分隔的ID列表', true);
        $this->registerArgument('value', 'int', '需要校验的页面ID', true);
    }

    public function render()
    {
        $idList = GeneralUtility::trimExplode(',', $this->arguments['list'], true);
        $currentPageId = (int)$this->arguments['value'];
        return in_array($currentPageId, $idList, true);
    }

    // 实现缓存变体方法，按页面ID区分缓存
    public function getCacheKeyVariants(): array
    {
        $pageId = $GLOBALS['TSFE']->id ?? 0;
        return [
            'pageId' => (string)$pageId
        ];
    }
}

方案2：添加缓存上下文变量 #

在ViewHelper的渲染方法中，将当前页面ID加入缓存上下文，让TYPO3缓存系统感知到页面维度的差异：

<?php
namespace YourVendor\YourExtension\ViewHelpers;

use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Fluid\Core\ViewHelper\AbstractViewHelper;

class InListViewHelper extends AbstractViewHelper
{
    public function initializeArguments()
    {
        parent::initializeArguments();
        $this->registerArgument('list', 'string', '逗号分隔的ID列表', true);
        $this->registerArgument('value', 'int', '需要校验的页面ID', true);
    }

    public function render()
    {
        $pageId = $GLOBALS['TSFE']->id ?? 0;
        // 将页面ID加入缓存上下文，区分不同页面的缓存
        $this->renderingContext->getCacheContext()->addVariable('pageId', $pageId);

        $idList = GeneralUtility::trimExplode(',', $this->arguments['list'], true);
        $currentPageId = (int)$this->arguments['value'];
        return in_array($currentPageId, $idList, true);
    }
}

验证与注意事项 #

1. 确保Fluid模板中传入的value参数为当前页面ID，比如使用{data.uid}或{page.uid}（根据TYPO3版本调整）。
2. 修改完成后，清空一次页面缓存再测试效果。
3. 若ID列表来自TypoScript配置，确保配置是全局或对应页面的正确值，避免配置被缓存干扰。

内容的提问来源于stack exchange，提问作者Stefan Müller