如何在Symfony 4中展示从关系数据库取数的下拉表单？

嘿，我来一步步教你在Symfony 4里实现从关系数据库拉取数据的下拉菜单——这其实是Symfony表单组件结合Doctrine关联的常规操作，上手很简单。

1. 先确认实体关联配置正确 #

首先你得确保你的Doctrine实体关联已经配置妥当。举个例子，假设我们有Category（分类）和Product（产品）两个实体，每个产品属于一个分类，那我们需要在实体里建立ManyToOne和OneToMany的关联：

Product实体（多对一关联到Category） #

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

use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
 */
class Product
{
    // ... 其他字段和方法

    /**
     * @ORM\ManyToOne(targetEntity="App\Entity\Category", inversedBy="products")
     * @ORM\JoinColumn(nullable=false)
     */
    private $category;

    // Getter和Setter方法
    public function getCategory(): ?Category
    {
        return $this->category;
    }

    public function setCategory(?Category $category): self
    {
        $this->category = $category;
        return $this;
    }

    // 可选：如果后续没在表单里指定choice_label，记得添加这个方法
    public function __toString()
    {
        return $this->getName(); // 假设Category实体有name字段
    }
}

Category实体（一对多关联到Product） #

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

use Doctrine\Common\Collections\ArrayCollection;
use Doctrine\Common\Collections\Collection;
use Doctrine\ORM\Mapping as ORM;

/**
 * @ORM\Entity(repositoryClass="App\Repository\CategoryRepository")
 */
class Category
{
    /**
     * @ORM\Id()
     * @ORM\GeneratedValue()
     * @ORM\Column(type="integer")
     */
    private $id;

    /**
     * @ORM\Column(type="string", length=255)
     */
    private $name;

    /**
     * @ORM\OneToMany(targetEntity="App\Entity\Product", mappedBy="category")
     */
    private $products;

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

    // Getter和Setter方法
    public function getId(): ?int
    {
        return $this->id;
    }

    public function getName(): ?string
    {
        return $this->name;
    }

    public function setName(string $name): self
    {
        $this->name = $name;
        return $this;
    }

    // ... 其他关联相关方法
}

2. 创建表单类型，用EntityType拉取数据 #

Symfony提供了EntityType表单字段，专门用来从数据库中读取实体并生成下拉选项。我们在表单类里配置这个字段：

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

use App\Entity\Product;
use App\Entity\Category;
use Symfony\Bridge\Doctrine\Form\Type\EntityType;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class ProductType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder
            ->add('name')
            ->add('price')
            ->add('category', EntityType::class, [
                // 指定关联的实体类
                'class' => Category::class,
                // 下拉选项显示的实体字段（这里用Category的name）
                'choice_label' => 'name',
                // 可选：自定义查询，比如按名称排序，或者过滤特定分类
                'query_builder' => function ($entityRepository) {
                    return $entityRepository->createQueryBuilder('c')
                        ->orderBy('c.name', 'ASC');
                },
                // 表单标签文本
                'label' => '所属分类',
                // 可选：添加默认空选项
                'placeholder' => '请选择分类',
            ]);
    }

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

3. 在控制器中处理表单 #

接下来在控制器里创建表单实例，处理请求，并把表单传递给模板：

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

use App\Entity\Product;
use App\Form\ProductType;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

class ProductController extends AbstractController
{
    /**
     * @Route("/product/new", name="product_new")
     */
    public function new(Request $request): Response
    {
        $product = new Product();
        $form = $this->createForm(ProductType::class, $product);

        $form->handleRequest($request);
        if ($form->isSubmitted() && $form->isValid()) {
            $entityManager = $this->getDoctrine()->getManager();
            $entityManager->persist($product);
            $entityManager->flush();

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

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

4. 在Twig模板中渲染下拉菜单 #

最后在模板里渲染表单的下拉字段即可：

{# templates/product/new.html.twig #}
{% extends 'base.html.twig' %}

{% block body %}
    <h1>添加新产品</h1>

    {{ form_start(form) }}
        {# 单独渲染分类下拉菜单 #}
        {{ form_row(form.category) }}
        {{ form_row(form.name) }}
        {{ form_row(form.price) }}
        <button type="submit" class="btn btn-primary">保存</button>
    {{ form_end(form) }}
{% endblock %}

几个实用小提示 #

• 注意：如果你的实体没有定义__toString()方法，一定要在EntityType的choice_label里明确指定要显示的字段（比如上面的'name'），否则会抛出错误。
• 要是需要多选下拉菜单，只需要在EntityType的配置里添加'multiple' => true即可。
• 通过query_builder可以灵活过滤数据，比如只显示状态为启用的分类，或者按特定条件排序。

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