TYPO3扩展模板缓存配置：修改fileadmin后强制重执行模板内PHP代码

我太懂这种缓存卡壳的烦恼了！你说得没错，TYPO3的页面/模板缓存会把渲染后的内容存起来，导致你的动态PHP代码不会每次请求都执行。下面给你几个不同场景下的解决方案：

一、开发环境：直接禁用模板缓存（快速粗暴） #

如果你只是在开发调试，完全可以临时关掉前端缓存，让模板每次都重新执行PHP代码：

1. 通过配置文件修改：
   在你的AdditionalConfiguration.php或者LocalConfiguration.php里添加以下代码：

// 禁用页面缓存
$GLOBALS['TYPO3_CONF_VARS']['FE']['cache']['pages'] = 0;
// 禁用页面片段缓存
$GLOBALS['TYPO3_CONF_VARS']['FE']['cache']['pagePart'] = 0;

2. 通过后端UI操作：
   登录TYPO3后端，点击顶部的「设置」图标，找到「配置」->「前端缓存」，勾选「禁用页面缓存」和「禁用页面片段缓存」即可。

⚠️ 注意：绝对不要在生产环境这么做，会严重拖慢网站性能！

二、生产环境：让缓存依赖fileadmin的文件变化（推荐） #

生产环境必须保留缓存，但我们可以让TYPO3知道：当fileadmin里的文件/文件夹变化时，对应的缓存就失效。这里有两种实现方式：

方式1：在模板PHP代码中添加缓存依赖 #

在你生成DOM的PHP代码里，获取目标fileadmin目录的最后修改时间，把它作为缓存的过期依据：

// 获取TYPO3缓存管理器
$cacheManager = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(\TYPO3\CMS\Core\Cache\CacheManager::class);
$pageCache = $cacheManager->getCache('pages');

// 定义你要监控的fileadmin目录
$targetDir = \TYPO3\CMS\Core\Core\Environment::getPublicPath() . '/fileadmin/your_target_folder/';
// 获取目录的最后修改时间
$lastModified = filemtime($targetDir);

// 假设你已经生成了动态DOM内容$content
// 设置缓存时，把修改时间作为过期时间，目录一变缓存就失效
$pageCache->set($GLOBALS['TSFE']->getCacheId(), $content, [], $lastModified);

方式2：用缓存标签+事件监听器自动清缓存 #

1. 首先在你的模板PHP代码里给动态内容添加专属缓存标签：

// 给当前页面缓存添加自定义标签
$GLOBALS['TSFE']->addCacheTags(['fileadmin_dynamic_content']);

2. 然后写一个事件监听器，当fileadmin的文件被修改/删除/添加时，自动清除这个标签的缓存。你可以在扩展的Configuration/Services.yaml里注册监听器：

services:
  Vendor\YourExtension\EventListener\FileadminChangeListener:
    tags:
      - name: event.listener
        identifier: 'your-extension/fileadmin-change-listener'
        event: TYPO3\CMS\Core\Resource\Event\FilePostProcessEvent

然后创建对应的监听器类：

namespace Vendor\YourExtension\EventListener;

use TYPO3\CMS\Core\Cache\CacheManager;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Core\Resource\Event\FilePostProcessEvent;

class FileadminChangeListener
{
    public function __invoke(FilePostProcessEvent $event): void
    {
        // 只监听fileadmin目录的变化
        $file = $event->getFile();
        if (str_starts_with($file->getIdentifier(), 'fileadmin/')) {
            // 清除带自定义标签的缓存
            $cacheManager = GeneralUtility::makeInstance(CacheManager::class);
            $cacheManager->flushCachesByTag('fileadmin_dynamic_content');
        }
    }
}

这样只要fileadmin里的文件有变化，对应的缓存就会自动清除，完美兼顾性能和动态更新。

三、更规范的做法：用Fluid ViewHelper替代模板里的原生PHP #

如果你的模板是Fluid格式，尽量不要直接写PHP代码，而是封装成自定义ViewHelper，这样TYPO3能更好地管理缓存逻辑。比如创建一个读取fileadmin文件的ViewHelper，在里面处理缓存依赖：

namespace Vendor\YourExtension\ViewHelpers;

use TYPO3\CMS\Core\Core\Environment;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Core\Cache\CacheManager;
use TYPO3Fluid\Fluid\Core\ViewHelper\AbstractViewHelper;

class FileadminFilesViewHelper extends AbstractViewHelper
{
    public function initializeArguments()
    {
        $this->registerArgument('directory', 'string', '目标fileadmin目录路径', true);
    }

    public function render()
    {
        $dirPath = Environment::getPublicPath() . '/' . $this->arguments['directory'];
        $files = scandir($dirPath);
        
        // 这里写你的DOM生成逻辑，比如遍历文件生成列表
        $content = '<ul>';
        foreach ($files as $file) {
            if ($file !== '.' && $file !== '..') {
                $content .= '<li>' . htmlspecialchars($file) . '</li>';
            }
        }
        $content .= '</ul>';

        // 设置缓存依赖：当目录修改时，缓存失效
        $lastModified = filemtime($dirPath);
        $this->renderingContext->getViewHelperVariableContainer()
            ->add('TYPO3\CMS\Fluid\ViewHelpers\CacheViewHelper', 'cacheLifetime', $lastModified);

        return $content;
    }
}

然后在Fluid模板里直接调用这个ViewHelper：

<your:fileadminFiles directory="fileadmin/your_files/" />

这种方式更符合TYPO3的开发规范，也更易于维护。

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