TYPO3 12后端模块：如何存储复选框值并在前端调用？

最佳实践说明 #

对于扩展的全局开关类设置，官方推荐使用**TYPO3扩展配置（EXTENSIONS）**存储，无需自定义数据库表，配置会持久化到系统表sys_config，且能在前后端便捷调用。

步骤1：添加扩展配置模板文件 #

在你的扩展根目录（typo3conf/ext/lj_barrierefrei/）创建ext_conf_template.txt，定义配置项：

enable_barrierefrei = 0
    type = checkbox
    label = 启用无障碍模式
    description = 勾选后前端将启用无障碍相关功能

该文件会被TYPO3自动识别，生成配置存储的底层逻辑。

步骤2：修改后端控制器，实现配置读写 #

更新BackendController.php，注入ExtensionConfiguration类处理配置的读取与保存：

<?php

namespace LjBarrierefrei\Controller;

use TYPO3\CMS\Backend\Attribute\AsController;
use TYPO3\CMS\Backend\Template\ModuleTemplateFactory;
use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;
use Psr\Http\Message\ResponseInterface;
use TYPO3\CMS\Core\Configuration\ExtensionConfiguration;

#[AsController]
final class BackendController extends ActionController
{
    public function __construct(
        protected readonly ModuleTemplateFactory $moduleTemplateFactory,
        protected readonly ExtensionConfiguration $extensionConfiguration
    ) {
    }

    public function indexAction(): ResponseInterface
    {
        // 读取当前配置值
        $extensionKey = 'lj_barrierefrei';
        $config = $this->extensionConfiguration->get($extensionKey);
        $this->view->assign('enableBarrierefrei', (bool)$config['enable_barrierefrei']);

        $moduleTemplate = $this->moduleTemplateFactory->create($this->request);
        $moduleTemplate->setContent($this->view->render());
        return $this->htmlResponse($moduleTemplate->renderContent());
    }

    public function saveAction(): ResponseInterface
    {
        // 获取表单提交的复选框值
        $enableBarrierefrei = $this->request->getParsedBody()['enable_barrierefrei'] ?? 0;
        $extensionKey = 'lj_barrierefrei';

        // 保存配置
        $this->extensionConfiguration->set(
            $extensionKey,
            ['enable_barrierefrei' => (int)$enableBarrierefrei]
        );

        // 重定向回模块首页
        return $this->redirect('index');
    }
}

步骤3：调整Fluid后端模板 #

确保复选框状态正确绑定配置值，你的Index.html模板可直接使用现有结构：

<div class="m-lg-5 border p-4">
<h1>无障碍设置</h1>
    <p>您可在此配置模块设置。</p>
    <f:form action="save">
        <label>
            <f:form.checkbox name="enable_barrierefrei" value="1" checked="{enableBarrierefrei}" />
            启用无障碍模式
        </label>
        <f:form.submit value="保存" />
    </f:form>
</div>

步骤4：前端Fluid模板调用配置 #

在扩展的TypoScript配置文件（如Configuration/TypoScript/setup.typoscript）中添加映射：

plugin.tx_ljbarrierefrei.settings {
    enable_barrierefrei = {$EXTENSIONS/lj_barrierefrei/enable_barrierefrei}
}

之后在前端Fluid模板中，即可通过{settings.enable_barrierefrei}调用该配置值。

常见疑问解答 #

• 是否需要自定义数据库表？
  不需要。扩展配置会自动存储到TYPO3系统表sys_config中，无需额外建表。
• 能否用$GLOBALS['TYPO3_CONF_VARS']存储？
  是的，扩展配置实际就存储在$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['lj_barrierefrei']中，通过ExtensionConfiguration类操作是官方推荐的安全方式。
• TYPO3 12后端模块存储设置的最佳实践？
  全局/扩展级别的开关、参数类设置优先使用扩展配置；如果是需要多条目、动态管理的数据，才考虑自定义数据库表。

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