如何从Twig动态生成的HTML表单中获取上传文件？

一、原生表单修复与文件获取 #

你的表单首先缺少**enctype="multipart/form-data"**属性——这是文件上传表单的必填项，不加的话服务器只能接收到文件名，无法获取完整的文件对象。先修改Twig模板：

<form action="my_route" method="POST" enctype="multipart/form-data">
    {% for file in files %}
        <label>Current file: {{ file.name }}</label><br>
        <label>File to replace (optional): </label>
        <input name="{{ file.id }}" type="file"><br>
    {% endfor %}
    <button type="submit">Send</button>
</form>

之后在控制器中，通过Request对象的files属性获取UploadedFile实例：

public function handleFileUpload(Request $request): Response
{
    // 遍历所有上传的文件
    foreach ($request->files as $fileId => $uploadedFile) {
        // 检查是否有有效文件上传（因为是可选字段）
        if ($uploadedFile instanceof \Symfony\Component\HttpFoundation\File\UploadedFile && !$uploadedFile->getError()) {
            // 示例：将文件移动到服务器指定目录
            $uploadedFile->move(
                $this->getParameter('kernel.project_dir').'/public/uploads',
                $uploadedFile->getClientOriginalName()
            );
            // 这里的$fileId对应模板中的file.id，可关联服务器原有文件进行替换
        }
    }

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

如果需要单独获取某个指定ID的文件：

$targetFile = $request->files->get('specific_file_id');
if ($targetFile instanceof \Symfony\Component\HttpFoundation\File\UploadedFile && !$targetFile->getError()) {
    // 处理单个文件逻辑
}

二、使用Symfony表单组件简化操作 #

用Symfony表单组件可以更规范地处理验证与字段管理，以下是实现方式：

1. 控制器中动态构建表单 #

use Symfony\Component\Form\Extension\Core\Type\FileType;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;

public function handleFileReplacement(Request $request): Response
{
    // 假设$files是从数据库/服务获取的服务器文件列表
    $files = $this->getDoctrine()->getRepository(File::class)->findAll();

    // 动态添加对应ID的文件字段
    $formBuilder = $this->createFormBuilder()
        ->setAction($this->generateUrl('my_route'))
        ->setMethod('POST');

    foreach ($files as $file) {
        $formBuilder->add((string)$file->getId(), FileType::class, [
            'label' => sprintf('Replace "%s" (optional)', $file->getName()),
            'required' => false,
        ]);
    }

    $form = $formBuilder->getForm();
    $form->handleRequest($request);

    if ($form->isSubmitted() && $form->isValid()) {
        $uploadedFiles = $form->getData();
        foreach ($uploadedFiles as $fileId => $uploadedFile) {
            if ($uploadedFile instanceof \Symfony\Component\HttpFoundation\File\UploadedFile) {
                // 替换服务器原有文件逻辑
                $serverFilePath = $this->getParameter('kernel.project_dir').'/path/to/server/files/'.$fileId;
                $uploadedFile->move(dirname($serverFilePath), basename($serverFilePath));
            }
        }

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

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

2. Twig模板渲染表单 #

{{ form_start(form, {'enctype': 'multipart/form-data'}) }}
    {% for file in files %}
        <label>Current file: {{ file.name }}</label><br>
        {{ form_row(form[file.id]) }}<br>
    {% endfor %}
    <button type="submit">Send</button>
{{ form_end(form) }}

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