TYPO3 v12中如何创建带用户组的前端用户会话？

背景说明 #

在TYPO3 v10版本中，我们曾通过以下代码创建用户并模拟用户组：

$sessionData = array_merge([
    'uid' => 0,
    'usergroup' => $this->settings['userGroupUid'],
    'status' => 'login'
], $loginResponse->getData());

$this->getFeUser()->dontSetCookie = false;
$this->getFeUser()->createSessionId();
$this->getFeUser()->setAndSaveSessionData(Client::SESSION_KEY, $sessionData);

但TYPO3 v12移除了createSessionId()方法，需采用新的方式实现相同功能。

TYPO3 v12适配方案 #

在TYPO3 v12中，前端用户会话的创建依赖FrontendUserAuthentication类的新逻辑，核心是通过start()方法自动处理会话初始化，同时确保上下文能识别用户信息，具体代码如下：

use TYPO3\CMS\Core\Context\Context;
use TYPO3\CMS\Core\Context\UserAspect;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Frontend\Authentication\FrontendUserAuthentication;

// 构建包含用户组的会话数据
$sessionData = array_merge([
    'uid' => 0,
    'usergroup' => $this->settings['userGroupUid'],
    'status' => 'login'
], $loginResponse->getData());

/** @var FrontendUserAuthentication $feUser */
$feUser = $this->getFeUser();
$feUser->dontSetCookie = false;

// 初始化会话：自动生成会话ID、处理存储及Cookie设置
$feUser->start();
// 保存自定义会话数据
$feUser->setAndSaveSessionData(Client::SESSION_KEY, $sessionData);

// 更新上下文，确保当前请求能识别会话用户
$context = GeneralUtility::makeInstance(Context::class);
$context->setAspect(
    'frontend.user',
    GeneralUtility::makeInstance(UserAspect::class, $feUser)
);

关键变化点 #

• 用$feUser->start()替代createSessionId()：该方法会自动完成会话ID生成、会话存储初始化及Cookie设置的全流程，覆盖v10中手动调用createSessionId()的功能。
• 新增上下文用户Aspect设置：确保当前请求的上下文能正确识别已创建的前端用户，避免后续权限校验等逻辑无法获取用户信息。
• setAndSaveSessionData()方法保持可用，仍用于存储自定义会话数据。

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