Silverstripe多对多关联创建过程中如何添加自定义额外字段？

方式一：使用可编辑列直接在关联列表中修改额外字段（推荐） #

这是最简便的实现方式，无需自定义复杂的GridField组件，借助GridFieldEditableColumns组件即可实现额外字段的可视化编辑，组件会自动处理保存逻辑，将值写入多对多关联表。
你可以直接在Product类的getCMSFields方法中调整关联GridField的配置：

public function getCMSFields()
{
    $fields = parent::getCMSFields();

    /** @var GridField $documentsGrid */
    $documentsGrid = $fields->dataFieldByName('Documents');
    $config = $documentsGrid->getConfig();

    // 新增可编辑列组件
    $editableColumns = \SilverStripe\GridFieldExtensions\GridFieldEditableColumns::create();
    $editableColumns->setDisplayFields([
        'Title' => [
            'title' => '文档标题',
            'field' => \SilverStripe\Forms\ReadonlyField::class,
        ],
        'DisplayOrder' => [
            'title' => '显示顺序',
            'field' => \SilverStripe\Forms\NumericField::class,
        ],
        'DisplayedField' => [
            'title' => '显示字段',
            'field' => \SilverStripe\Forms\DropdownField::class,
            'extra' => [
                'source' => [
                    'cover' => '封面',
                    'content' => '正文',
                    'appendix' => '附录'
                ]
            ]
        ]
    ]);
    $config->addComponent($editableColumns);

    // 新增列表保存按钮
    $config->addComponent(\SilverStripe\GridFieldExtensions\GridFieldSaveButton::create());

    return $fields;
}

方式二：使用系统自带的多对多钩子处理保存逻辑 #

SilverStripe提供了原生的多对多操作钩子，对应你需要的类似onRelationSet的能力：

• onBeforeManyManyAdd($relationName, $itemIDs, $extraFields)：关联添加前触发
• onAfterManyManyAdd($relationName, $itemIDs, $extraFields)：关联添加后触发
• onBeforeManyManyRemove($relationName, $itemIDs)：关联移除前触发
• onAfterManyManyRemove($relationName, $itemIDs)：关联移除后触发

你可以直接在Product类中定义对应钩子方法处理额外字段赋值，示例代码：

public function onAfterManyManyAdd($relationName, $addedIDList, $extraFields)
{
    if ($relationName === 'Documents') {
        foreach ($addedIDList as $docID) {
            // 示例：给新添加的关联设置默认值
            $this->Documents()->add($docID, [
                'DisplayOrder' => 99,
                'DisplayedField' => 'content'
            ], false);
        }
    }
}

方式三：代码层面手动赋值 #

如果你是在自定义逻辑中手动创建关联，直接给add方法传第二个参数即可写入额外字段：

$product = Product::get()->byID(1);
$document = Document::get()->byID(10);
// 第二个参数为额外字段数组，会自动写入关联表
$product->Documents()->add($document, [
    'DisplayOrder' => 1,
    'DisplayedField' => 'cover'
]);

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