在Symfony4中使用FOSRestBundle通过单次POST请求持久化多个实体

你这个思路完全没问题——用一个集合类来包裹多个实体，就是处理批量提交的标准操作，我帮你把这个方案补全，把关键步骤理清楚：

首先要给集合类补上初始化逻辑、add/remove方法，还有验证注解，确保每个子实体都能被正确验证：

use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;
use Symfony\Component\Validator\Constraints as Assert;

class MyEntityCollection
{
    /**
     * @var Collection<int, MyEntity>
     * @Assert\Valid() // 关键：确保每个MyEntity实例都能触发自身的验证规则
     */
    protected $myEntities;

    public function __construct()
    {
        $this->myEntities = new ArrayCollection();
    }

    public function getMyEntities(): Collection
    {
        return $this->myEntities;
    }

    public function addMyEntity(MyEntity $myEntity): void
    {
        if (!$this->myEntities->contains($myEntity)) {
            $this->myEntities->add($myEntity);
        }
    }

    public function removeMyEntity(MyEntity $myEntity): void
    {
        $this->myEntities->removeElement($myEntity);
    }
}

你之前应该已经有了单个MyEntity对应的表单类型（比如MyEntityType），现在要做一个集合表单来关联它：

use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\Form\Extension\Core\Type\CollectionType;
use Symfony\Component\OptionsResolver\OptionsResolver;

class MyEntityCollectionType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder->add('myEntities', CollectionType::class, [
            'entry_type' => MyEntityType::class, // 替换成你现有的单个实体表单类型
            'allow_add' => true,
            'allow_delete' => true,
            'by_reference' => false, // 必须设为false，这样才会调用我们写的add/remove方法
            'error_bubbling' => false, // 让错误信息关联到具体的子实体，方便前端定位
        ]);
    }

    public function configureOptions(OptionsResolver $resolver)
    {
        $resolver->setDefaults([
            'data_class' => MyEntityCollection::class,
            'csrf_protection' => false, // API场景下通常关闭CSRF防护，根据你的需求调整
        ]);
    }
}

用FOSRestBundle的View组件来处理请求和响应，逻辑和单个提交类似，只是换成处理集合：

use FOS\RestBundle\Controller\AbstractFOSRestController;
use FOS\RestBundle\View\View;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;

class MyEntityController extends AbstractFOSRestController
{
    public function postMyEntitiesBatchAction(Request $request)
    {
        $collection = new MyEntityCollection();
        $form = $this->createForm(MyEntityCollectionType::class, $collection);
        
        // 处理JSON格式的请求
        $form->submit($request->request->all());
        
        if ($form->isSubmitted() && $form->isValid()) {
            $entityManager = $this->getDoctrine()->getManager();
            
            // 批量持久化所有实体
            foreach ($collection->getMyEntities() as $entity) {
                $entityManager->persist($entity);
            }
            
            $entityManager->flush(); // 只需要一次flush，提升性能
            
            // 返回创建成功的响应，自动序列化集合数据
            return View::create($collection, Response::HTTP_CREATED);
        }
        
        // 返回验证错误详情
        return View::create($form->getErrors(true), Response::HTTP_BAD_REQUEST);
    }
}

用FOSRestBundle的注解路由来定义批量提交的接口：

use FOS\RestBundle\Controller\Annotations as Rest;

/**
 * @Rest\Route("/api/my-entities")
 */
class MyEntityController extends AbstractFOSRestController
{
    /**
     * 批量创建MyEntity实体
     * @Rest\Post("/batch", name="api_my_entities_batch_create")
     * @Rest\View(serializerGroups={"my_entity"}) // 如果你用序列化组，在这里指定
     */
    public function postMyEntitiesBatchAction(Request $request)
    {
        // ... 上面的控制器逻辑
    }
}

提交的JSON格式要和集合类的结构对应：

{
  "myEntities": [
    {
      "field1": "测试值1",
      "field2": "测试内容1"
    },
    {
      "field1": "测试值2",
      "field2": "测试内容2"
    }
  ]
}

• 如果你更倾向于用Serializer而非表单处理数据，可以在FOSRestBundle配置里开启自动反序列化，直接将请求体映射到MyEntityCollection类，不过表单方式自带验证，更适合API场景
• 确保你的MyEntity类已经配置了正确的ORM注解，能被Doctrine持久化
• 如果批量数据量很大，建议考虑分批次处理或者使用Doctrine的批量插入优化，避免内存溢出

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