Symfony 6下EasyAdmin 4非图片文件上传字段配置求助

1. 实体类基础配置 #

首先确保你的实体（示例用Document）中，file字段用于存储上传文件的文件名（字符串类型），同时添加文件上传的核心处理逻辑：

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

use Doctrine\ORM\Mapping as ORM;
use Symfony\Component\HttpFoundation\File\UploadedFile;
use Symfony\Component\String\Slugger\SluggerInterface;
use Symfony\Component\HttpFoundation\File\File;
use Symfony\Component\Validator\Constraints as Assert;

#[ORM\Entity]
#[ORM\HasLifecycleCallbacks]
class Document
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    private $id;

    #[ORM\Column(type: 'string', length: 255)]
    private ?string $file = null;

    // 临时存储上传的文件对象（不映射到数据库）
    private ?File $uploadedFile = null;

    #[Assert\File(
        maxSize: '10M',
        mimeTypes: ['application/pdf', 'application/msword', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document'],
        mimeTypesMessage: '请上传有效的PDF或Word文档'
    )]
    public function getUploadedFile(): ?File
    {
        return $this->uploadedFile;
    }

    public function setUploadedFile(?File $uploadedFile): void
    {
        $this->uploadedFile = $uploadedFile;
        // 新文件上传时标记需要更新文件名
        if ($uploadedFile) {
            $this->file = uniqid().'.'.$uploadedFile->guessExtension();
        }
    }

    #[ORM\PrePersist]
    #[ORM\PreUpdate]
    public function upload(SluggerInterface $slugger): void
    {
        if (!$this->uploadedFile) {
            return;
        }

        // 生成安全的文件名
        $originalFilename = pathinfo($this->uploadedFile->getClientOriginalName(), PATHINFO_FILENAME);
        $safeFilename = $slugger->slug($originalFilename);
        $this->file = $safeFilename.'-'.uniqid().'.'.$this->uploadedFile->guessExtension();

        // 将文件移动到目标存储目录
        $this->uploadedFile->move(
            $this->getUploadDir(),
            $this->file
        );

        $this->uploadedFile = null;
    }

    public function getUploadDir(): string
    {
        // 上传文件存储的目录（示例：public/uploads/documents）
        return 'uploads/documents';
    }

    // 基础getter/setter
    public function getId(): ?int
    {
        return $this->id;
    }

    public function getFile(): ?string
    {
        return $this->file;
    }

    public function setFile(?string $file): void
    {
        $this->file = $file;
    }
}

2. EasyAdmin Crud控制器配置 #

在Crud控制器中，使用TextField覆盖为FileUploadType，同时配置上传目录、权限、文件类型限制等关键选项：

// src/Controller/Admin/DocumentCrudController.php
namespace App\Controller\Admin;

use App\Entity\Document;
use EasyCorp\Bundle\EasyAdminBundle\Config\Crud;
use EasyCorp\Bundle\EasyAdminBundle\Controller\AbstractCrudController;
use EasyCorp\Bundle\EasyAdminBundle\Field\IdField;
use EasyCorp\Bundle\EasyAdminBundle\Field\TextField;
use EasyCorp\Bundle\EasyAdminBundle\Form\Type\FileUploadType;

class DocumentCrudController extends AbstractCrudController
{
    public static function getEntityFqcn(): string
    {
        return Document::class;
    }

    public function configureFields(string $pageName): iterable
    {
        $fields = [
            IdField::new('id')->hideOnForm(),
            TextField::new('uploadedFile')
                ->setFormType(FileUploadType::class)
                ->setFormTypeOptions([
                    'upload_dir' => 'public/uploads/documents',
                    'allow_file_download' => true,
                    'allowed_file_types' => ['pdf', 'doc', 'docx'],
                    'download_path' => function ($entity) {
                        return '/uploads/documents/'.$entity->getFile();
                    },
                ])
                ->onlyOnForms(),
        ];

        // 详情页显示可下载的文件链接
        if (Crud::PAGE_DETAIL === $pageName) {
            $fields[] = TextField::new('file')
                ->setTemplatePath('admin/fields/document_link.html.twig');
        }

        return $fields;
    }
}

3. 自定义详情页模板（可选） #

创建模板文件templates/admin/fields/document_link.html.twig，用于在详情页显示可点击的下载链接：

{% if field.value %}
    <a href="{{ asset('uploads/documents/' ~ field.value) }}" target="_blank">
        下载文件: {{ field.value }}
    </a>
{% else %}
    <span>无上传文件</span>
{% endif %}

关键注意事项 #

• 确保上传目录（如public/uploads/documents）存在且有写入权限，可通过命令创建：mkdir -p public/uploads/documents && chmod 775 public/uploads/documents
• FileUploadType的选项可按需调整，比如allowed_file_types支持扩展名或MIME类型数组
• 实体中的upload方法依赖SluggerInterface，Symfony会自动完成服务注入

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