TYPO3针对不同权限用户的自定义页面缓存方案咨询

当然可以！你遇到的这个缓存串版问题，本质是TYPO3默认会给同一URL生成单一缓存副本，没考虑用户权限差异。不过通过调整缓存上下文和自定义标识，完全可以让系统为不同权限的用户存储对应版本的页面缓存，下面给你一步步讲怎么实现：

1. 利用TYPO3缓存上下文区分权限状态 #

TYPO3的缓存系统允许你添加自定义上下文变量，这些变量会成为缓存标识的一部分——不同的变量值会触发不同的缓存版本生成。针对你的场景，我们可以把用户的权限状态（比如是否拥有"完全访问权限"）作为一个上下文变量。

首先在你的扩展TypoScript配置里（比如Configuration/TypoScript/setup.typoscript）添加：

config.cache {
  context = clientIp, language, fe_user_groups, fe_access_level
}

这里的fe_access_level是我们自定义的变量，接下来需要通过PHP逻辑把用户的权限状态注入到这个变量里。

2. 通过中间件注入权限上下文 #

我们可以写一个前端中间件，用来判断当前用户的权限状态，并把它添加到TYPO3的上下文系统中。

创建一个中间件文件Vendor\YourExtension\Middleware\AddAccessLevelToCacheContext.php：

<?php
namespace Vendor\YourExtension\Middleware;

use Psr\Http\Message\ResponseInterface;
use Psr\Http\Message\ServerRequestInterface;
use Psr\Http\Server\MiddlewareInterface;
use Psr\Http\Server\RequestHandlerInterface;
use TYPO3\CMS\Core\Context\Context;

class AddAccessLevelToCacheContext implements MiddlewareInterface
{
    public function __construct(protected Context $context) {}

    public function process(ServerRequestInterface $request, RequestHandlerInterface $handler): ResponseInterface
    {
        $frontendUser = $GLOBALS['TSFE']->fe_user;
        $hasFullAccess = false;
        
        // 这里替换成你的实际权限判断逻辑
        if ($frontendUser->user['uid']) {
            // 示例1：检查是否属于特定用户组（假设组ID是99）
            $userGroups = array_column($frontendUser->userGroups, 'uid');
            $hasFullAccess = in_array(99, $userGroups);
            
            // 示例2：检查fe_users表的关联字段/记录
            // $hasFullAccess = $frontendUser->user['has_full_access'] ?? false;
        }
        
        // 将权限状态存入上下文，值用"full"或"limited"区分
        $this->context->setProperty('fe_access_level', $hasFullAccess ? 'full' : 'limited');
        
        return $handler->handle($request);
    }
}

然后在Configuration/Services.yaml里注册这个中间件，确保它在TSFE初始化之后、页面解析之前运行：

services:
  Vendor\YourExtension\Middleware\AddAccessLevelToCacheContext:
    tags:
      - name: middleware
        after: 'typo3/cms-frontend/prepare-tsfe'
        before: 'typo3/cms-frontend/page-resolver'

3. 确保视图助手适配缓存逻辑 #

你之前用的权限检查视图助手，要保证它能识别缓存上下文的变化。如果是自定义视图助手，需要实现CacheableInterface，并声明它依赖我们的fe_access_level上下文：

use TYPO3\CMS\Core\Cache\CacheableInterface;

class YourAccessCheckViewHelper extends AbstractViewHelper implements CacheableInterface
{
    // ... 你的视图助手逻辑 ...

    public function getCacheTags(): array
    {
        return [];
    }

    public function getCacheLifetime(): ?int
    {
        return null;
    }

    public function getCacheContext(): array
    {
        // 声明这个视图助手依赖fe_access_level上下文
        return ['fe_access_level'];
    }
}

这样TYPO3就知道这个视图助手的输出会随权限状态变化，不会错误缓存固定内容。

4. 测试与验证 #

配置完成后，先清空整个TYPO3缓存，然后分别用三类用户测试：

• 未登录用户：系统会生成fe_access_level=limited的缓存版本
• 已登录无完全权限：同样匹配limited版本的缓存
• 已登录有完全权限：生成full版本的缓存

之后再切换用户访问，就能看到各自对应的页面内容了，不会再出现串缓存的问题。

额外注意事项 #

• 如果用户权限会动态变更（比如被添加/移除权限组），记得在权限变更时清除对应页面的缓存，避免用户看到旧内容。可以调用$cacheManager->flushCachesByTag('pageId_xxx')来精准清除单页缓存。
• 不要添加过多的缓存上下文变量，否则会导致缓存条目暴增，影响系统性能。这里只用fe_access_level就足够区分三类用户了。

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