Symfony 4：通过CollectionType嵌入FileType实现实体文档上传问题

这个错误很典型——你把Attachment实体直接传给了FileUploader::upload()方法，但它需要的是Symfony\Component\HttpFoundation\File\UploadedFile对象。咱们一步步来修复这个问题：

1. 确认Attachment实体的文件属性配置 #

首先要确保你的Attachment实体区分了临时存储上传文件的字段（不持久化到数据库）和存储文件名的持久化字段：

// src/Entity/Attachment.php
namespace App\Entity;

use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\HttpFoundation\File\UploadedFile;

class Attachment
{
    // 其他ORM注解的字段（比如ID等）...

    /**
     * 临时存储上传的文件，不需要ORM注解
     * @var UploadedFile|null
     */
    private $file;

    /**
     * 持久化到数据库的文件名
     * @ORM\Column(type="string", nullable=true)
     */
    private $fileName;

    // Getter & Setter
    public function getFile(): ?UploadedFile
    {
        return $this->file;
    }

    public function setFile(?UploadedFile $file): self
    {
        $this->file = $file;
        return $this;
    }

    public function getFileName(): ?string
    {
        return $this->fileName;
    }

    public function setFileName(?string $fileName): self
    {
        $this->fileName = $fileName;
        return $this;
    }
}

2. 配置表单类型 #

子表单：AttachmentType #

创建专门的附件表单，使用FileType关联到实体的file属性：

// src/Form/AttachmentType.php
namespace App\Form;

use App\Entity\Attachment;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;
use Symfony\Component\Form\Extension\Core\Type\FileType;

class AttachmentType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder
            ->add('file', FileType::class, [
                'label' => 'Attachment File',
                'required' => false, // 根据需求设置是否必填
                'mapped' => true, // 关联到Attachment实体的file属性
            ]);
    }

    public function configureOptions(OptionsResolver $resolver)
    {
        $resolver->setDefaults([
            'data_class' => Attachment::class,
        ]);
    }
}

父表单：InvoiceType #

在Invoice表单中嵌入CollectionType，注意开启by_reference: false确保实体能正确被添加：

// src/Form/InvoiceType.php
namespace App\Form;

use App\Entity\Invoice;
use App\Form\AttachmentType;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;
use Symfony\Component\Form\Extension\Core\Type\CollectionType;

class InvoiceType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder
            // 你的其他Invoice字段...
            ->add('attachments', CollectionType::class, [
                'entry_type' => AttachmentType::class,
                'allow_add' => true,
                'allow_delete' => true,
                'by_reference' => false, // 必须设置为false，确保实体关联正确
                'label' => 'Attachments'
            ]);
    }

    public function configureOptions(OptionsResolver $resolver)
    {
        $resolver->setDefaults([
            'data_class' => Invoice::class,
        ]);
    }
}

3. 控制器中正确处理上传逻辑 #

在提交表单后，遍历Invoice的所有附件，取出Attachment实体中的UploadedFile对象再传给FileUploader：

// src/Controller/InvoiceController.php
namespace App\Controller;

use App\Entity\Invoice;
use App\Form\InvoiceType;
use App\Service\FileUploader;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

class InvoiceController extends AbstractController
{
    #[Route('/invoice/new', name: 'invoice_new')]
    public function new(Request $request, FileUploader $fileUploader): Response
    {
        $invoice = new Invoice();
        $form = $this->createForm(InvoiceType::class, $invoice);
        $form->handleRequest($request);

        if ($form->isSubmitted() && $form->isValid()) {
            // 遍历每个附件，上传文件并设置文件名
            foreach ($invoice->getAttachments() as $attachment) {
                $uploadedFile = $attachment->getFile();
                if ($uploadedFile) {
                    // 这里传入的是UploadedFile对象，而非Attachment实体
                    $fileName = $fileUploader->upload($uploadedFile);
                    $attachment->setFileName($fileName);
                }
            }

            $entityManager = $this->getDoctrine()->getManager();
            $entityManager->persist($invoice);
            $entityManager->flush();

            return $this->redirectToRoute('invoice_index');
        }

        return $this->render('invoice/new.html.twig', [
            'invoice' => $invoice,
            'form' => $form->createView(),
        ]);
    }
}

4. 确认FileUploader服务的正确性 #

确保你的FileUploader服务参数确实是UploadedFile：

// src/Service/FileUploader.php
namespace App\Service;

use Symfony\Component\HttpFoundation\File\UploadedFile;

class FileUploader
{
    private $targetDirectory;

    public function __construct(string $targetDirectory)
    {
        $this->targetDirectory = $targetDirectory;
    }

    // 参数必须是UploadedFile类型
    public function upload(UploadedFile $file): string
    {
        $originalFilename = pathinfo($file->getClientOriginalName(), PATHINFO_FILENAME);
        $safeFilename = transliterator_transliterate('Any-Latin; Latin-ASCII; [^A-Za-z0-9_] remove; Lower()', $originalFilename);
        $fileName = $safeFilename.'-'.uniqid().'.'.$file->guessExtension();

        $file->move($this->getTargetDirectory(), $fileName);

        return $fileName;
    }

    public function getTargetDirectory(): string
    {
        return $this->targetDirectory;
    }
}

最后别忘了在services.yaml中配置上传目录：

# config/services.yaml
services:
    App\Service\FileUploader:
        arguments:
            $targetDirectory: '%kernel.project_dir%/public/uploads/attachments'

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