TYPO3 12 Forms自定义字段存入数据库失败的问题及解决尝试

一、自定义Finisher字段数据库存储的最优配置方案 #

你遇到的{mycustomfield}字符串直接存入数据库的问题，核心原因是自定义字段是Finisher的配置选项，而非表单元素，Form Runtime默认仅解析表单元素变量，需通过__finisherOption前缀引用Finisher自身的选项。

正确的YAML配置 #

修改finishersDefinition中的predefinedDefaults，用{__finisherOption.mycustomfield}替代原有的{mycustomfield}：

finishersDefinition:
  CustomFinisherSaveToDatabase:
    implementationClassName: TYPO3\CMS\Form\Domain\Finishers\SaveToDatabaseFinisher
    FormEngine:
      label: 'Custom SaveToDatabase'
      elements:
        mycustomfield:
          identifier: 'mycustomfieldidentifier'
          label: 'Custom Field'
          config:
            type: 'text'
    formEditor:
      iconIdentifier: 'form-finisher'
      label: 'Custom SaveToDatabase'
      predefinedDefaults:
        options:
          table: 'my_table'
          mode: insert
          databaseColumnMappings:
            tablefield1:
              value: '{__finisherOption.mycustomfield}'
            # 若mycustomfieldidentifier是表单元素标识符，直接用{mycustomfieldidentifier}即可
            tablefield2:
              value: '{mycustomfieldidentifier}'

• {__finisherOption.mycustomfield}：专门用于引用当前Finisher的自定义配置选项值
• 若mycustomfieldidentifier是表单内元素，直接用{mycustomfieldidentifier}就能解析表单提交的值

为什么之前的elements配置无效？ #

elements节点用于映射表单元素到数据库字段，而你的mycustomfield是Finisher的自定义配置字段，不属于表单元素，因此无法通过elements映射解析。

二、多复选框值存储的优雅处理方案 #

你修改FormState的临时方案虽可行，但侵入性较强，推荐两种配置式解决方案：

方案1：使用表单元素转换器（Transformer） #

在多复选框的元素配置中添加transformers，自动将数组转为逗号分隔的字符串：

type: Checkbox
identifier: myMulticheckbox
label: 多选选项
properties:
  options:
    option1: 选项1
    option2: 选项2
    option3: 选项3
transformers:
  10:
    identifier: ArrayToString
    options:
      separator: ','

提交时数组会自动转为option1,option2格式的字符串，直接存入数据库即可。

方案2：在Finisher配置中用表达式语言处理 #

若不想修改表单元素配置，可在databaseColumnMappings中用TYPO3表达式语言直接处理数组：

databaseColumnMappings:
  tablefield_multicheck:
    value: '${implode(",", value)}'

${implode(",", value)}会自动将多复选框的数组值转为逗号分隔的字符串。

三、自定义Finisher类的优化建议 #

你当前复制原类代码的方式冗余且难以维护，推荐继承原SaveToDatabaseFinisher并仅重写需修改的方法，避免重复代码：

<?php
namespace Vendor\YourExtension\Domain\Finishers;

use TYPO3\CMS\Form\Domain\Finishers\SaveToDatabaseFinisher;

class CustomSaveToDatabaseFinisher extends SaveToDatabaseFinisher
{
    protected function buildDatabaseData(): array
    {
        // 先调用父类方法获取默认数据库数据
        $databaseData = parent::buildDatabaseData();
        
        // 添加自定义字段映射逻辑
        $elementsConfig = $this->parseOption('elements');
        if (isset($elementsConfig['mycustomfield']['mapOnDatabaseColumn'])) {
            $databaseData[$elementsConfig['mycustomfield']['mapOnDatabaseColumn']] = $this->parseOption('mycustomfield');
        }
        
        return $databaseData;
    }
}

这种方式既保留原Finisher的所有功能，又能灵活添加自定义逻辑，后续TYPO3官方更新原类时，自定义类也能同步受益。

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