扩展Shopware 6 Product实体后，新建产品时如何保存自定义数据？

一、先确认实体扩展的基础配置（核对已完成的官方文档步骤细节） #

你的EntityExtension类必须正确关联产品定义，字段映射要和数据库完全一致：

<?php

namespace YourPlugin\Core\Content\Product\Extension;

use Shopware\Core\Content\Product\ProductDefinition;
use Shopware\Core\Framework\DataAbstractionLayer\EntityExtension;
use Shopware\Core\Framework\DataAbstractionLayer\Field\StringField;
use Shopware\Core\Framework\DataAbstractionLayer\FieldCollection;

class ProductSellerExtension extends EntityExtension
{
    public function extendFields(FieldCollection $collection): void
    {
        // 字段名需和数据库迁移文件中的定义对应
        $collection->add(new StringField('seller_name', 'sellerName'));
    }

    public function getDefinitionClass(): string
    {
        return ProductDefinition::class;
    }
}

同时确保数据库迁移文件已执行，不管是给product表新增字段，还是创建了关联的扩展表，都要保证结构和扩展类的字段定义匹配。

二、后台表单字段绑定（关键：让前端数据能传到后端） #

在Admin的自定义字段组件中，必须把输入框的v-model绑定到产品的扩展属性上，示例代码如下：

<sw-text-field
    v-model="product.extensions.sellerName"
    label="卖家名称"
    placeholder="请输入卖家名称"
></sw-text-field>

这样提交产品表单时，卖家名称会被打包到product.extensions对象中，后端能直接识别并处理。

三、数据自动持久化（无需额外编写保存逻辑） #

只要上面两步配置正确，Shopware的默认数据写入流程会自动处理扩展数据：

• 保存产品时，ProductWriter会自动读取product.extensions.sellerName的值，写入对应的数据库字段；
• 直接查询对应数据库表，即可验证数据是否成功存入。

四、将扩展数据加入product.written事件的Payload中 #

默认ProductWrittenEvent的实体对象已包含扩展数据，但要让它出现在事件的payload里，需要订阅事件手动添加：

1. 编写事件订阅类：

<?php

namespace YourPlugin\Core\Content\Product\Event;

use Shopware\Core\Content\Product\Event\ProductWrittenEvent;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;

class ProductWrittenSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [
            ProductWrittenEvent::class => 'addSellerDataToPayload',
        ];
    }

    public function addSellerDataToPayload(ProductWrittenEvent $event): void
    {
        foreach ($event->getEntities() as $product) {
            $sellerName = $product->getExtension('sellerName');
            if (!$sellerName) {
                continue;
            }
            
            // 将卖家名称追加到事件Payload中
            $payload = $event->getPayload();
            $payload['sellerName'] = $sellerName;
            $event->setPayload($payload);
        }
    }
}

2. 在插件的services.xml中注册该订阅器：

<service id="YourPlugin\Core\Content\Product\Event\ProductWrittenSubscriber">
    <tag name="kernel.event_subscriber"/>
</service>

完成后，当product.written事件触发时，就能在事件的payload中获取到sellerName的数据。

验证方式 #

1. 保存产品后，用调试工具监听product.written事件，检查Payload是否包含卖家名称；
2. 直接查询数据库，确认数据已正确写入。

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