Symfony2 更新“子窗体”中的项目一些内部要检查的内容

php doctrine-orm symfony symfony-forms

2022-08-30 23:43:18

我的问题的简短版本：

如何在 Symfony2 中编辑子窗体的实体？

=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

我有一个实体订单

<?php

class Order
{
    /**
     * @var integer
     *
     * @ORM\Column(name="id", type="integer")
     * @ORM\Id
     * @ORM\GeneratedValue(strategy="AUTO")
     */
    private $id;

    /**
     * @ORM\ManyToOne(targetEntity="Customer")
     * @ORM\JoinColumn(name="customer_id", referencedColumnName="id", nullable=false)
     **/
    private $customer;

    /**
     * @var \DateTime
     *
     * @ORM\Column(name="date", type="date")
     */
    private $date;

    /**
     * @ORM\ManyToOne(targetEntity="\AppBundle\Entity\OrderStatus")
     * @ORM\JoinColumn(name="order_status_id", referencedColumnName="id", nullable=false)
     **/
    private $orderStatus;

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

    /**
     * @var string
     *
     * @ORM\Column(name="comments", type="text")
     */
    private $comments;

    /**
     * @var array
     *
     * @ORM\OneToMany(targetEntity="OrderRow", mappedBy="Order", cascade={"persist"})
     */
    private $orderRows;

    ...
}

我的SQL

_____________________________________________________________
|id                           | order id                    |
|customer_id                  | fk customer.id NOT NULL     |
|date                         | order date                  |
|order_status_id              | fk order_status.id NOT NULL |
|reference                    | varchar order reference     |
|comments                     | text comments               |
|___________________________________________________________|

和实体 OrderRow（一个订单可以有一行或多行）

<?php

class OrderRow
{
    /**
     * @var integer
     *
     * @ORM\Column(name="id", type="integer")
     * @ORM\Id
     * @ORM\GeneratedValue(strategy="AUTO")
     */
    private $id;

    /**
     * @ORM\ManyToOne(targetEntity="Order", inversedBy="orderRows", cascade={"persist"})
     * @ORM\JoinColumn(name="order_id, referencedColumnName="id", nullable=false)
     **/
    private $order;

    /**
     * @ORM\ManyToOne(targetEntity="[MyShop\Bundle\ProductBundle\Entity\Product")
     * @ORM\JoinColumn(name="product_id", referencedColumnName="id", nullable=true)
     **/
    private $product;

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

    /**
     * @var integer
     *
     * @ORM\Column(name="count", type="integer")
     */
    private $count = 1;

    /**
     * @var \DateTime
     *
     * @ORM\Column(name="date", type="date")
     */
    private $date;

    /**
     * @var decimal
     *
     * @ORM\Column(name="amount", type="decimal", precision=5, scale=2)
     */
    private $amount;

    /**
     * @var string
     *
     * @ORM\Column(name="tax_amount", type="decimal", precision=5, scale=2)
     */
    private $taxAmount;

    /**
     * @var string
     *
     * @ORM\Column(name="discount_amount", type="decimal", precision=5, scale=2)
     */
    private $discountAmount;

    ...
}

我的SQL

_____________________________________________________________
|id                           | order id                    |
|order_id                     | fk order.id NOT NULL        |
|product_id                   | fk product.id               |
|description                  | varchar product description |
|count                        | int count                   |
|date                         | date                        |
|amount                       | amount                      |
|taxAmount                    | tax amount                  |
|discountAmount               | discount amount             |
|___________________________________________________________|

我想创建一个表单，允许编辑一个订单及其行。

订单类型.php

class OrderType extends AbstractType
{
    /**
     * @param FormBuilderInterface $builder
     * @param array $options
     */
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder
            ->add('customer', 'entity', array(
                'class' => 'Customer',
                'multiple' => false
            ))
            ->add('orderStatus', 'entity', array(
                'class' => 'AppBundle\Entity\OrderStatus',
                'multiple' => false
            ))
            ->add('date')
            ->add('reference')
            ->add('comments')
            ->add('orderRows', 'collection', [
                'type' => new OrderRowType(),
                'allow_add' => true,
                'by_reference' => false,
            ])
        ;
    }

    ...
}

OrderRowType.php

class OrderRowType extends AbstractType
{
    /**
     * @param FormBuilderInterface $builder
     * @param array $options
     */
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder
            ->add('order', 'entity', array(
                'class' => 'MyShop\Bundle\OrderBundle\Entity\Order',
                'multiple' => false
            ))
            ->add('product', 'product_selector') // service
            ->add('orderRowStatus', 'entity', array(
                'class' => 'AppBundle\Entity\OrderRowStatus',
                'multiple' => false
            ))
            ->add('description')
            ->add('count')
            ->add('startDate')
            ->add('endDate')
            ->add('amount')
            ->add('taxAmount')
            ->add('discountAmount')
        ;
    }

    ...
}

更新订单是通过向我的 API 发送请求来完成的：

请求网址： https://api.example.net/admin/orders/update/37
请求方法：开机自检

状态代码：200

Params: {

"order[customer]": "3",
"order[orderStatus]": "1",
"order[date][month]:": "5",
"order[date][day]": "18",
"order[date][year]": "2015",
"order[reference]": "Testing",
"order[comments]": "I have nothing to say!",
"order[orderRows][0][order]": "32",
"order[orderRows][0][product]": "16721",
"order[orderRows][0][orderRowStatus]:1": "1",
"order[orderRows][0][description]": "8 GB memory",
"order[orderRows][0][count]": "12",
"order[orderRows][0][startDate][month]": "5",
"order[orderRows][0][startDate][day]": "18",
"order[orderRows][0][startDate][year]": "2015",
"order[orderRows][0][endDate][month]": "5",
"order[orderRows][0][endDate][day]": "18",
"order[orderRows][0][endDate][year]": "2015",
"order[orderRows][0][amount]": "122.03",
"order[orderRows][0][taxAmount]": "25.63",
"order[orderRows][0][discountAmount]": "0",
"order[orderRows][1][order]": "32",
"order[orderRows][1][product]": "10352",
"order[orderRows][1][orderRowStatus]": "2",
"order[orderRows][1][description]": "12 GB MEMORY",
"order[orderRows][1][count]": "1",
"order[orderRows][1][startDate][month]": "5",
"order[orderRows][1][startDate][day]": "18",
"order[orderRows][1][startDate][year]": "2015",
"order[orderRows][1][endDate][month]": "5",
"order[orderRows][1][endDate][day]": "18",
"order[orderRows][1][endDate][year]": "2015",
"order[orderRows][1][amount]": "30.8",
"order[orderRows][1][taxAmount]": "6.47",
"order[orderRows][1][discountAmount]": "0",
"order[orderRows][2][order]": "32",
"order[orderRows][2][product]": "2128",
"order[orderRows][2][orderRowStatus]": "3",
"order[orderRows][2][description]": "4GB MEMORY",
"order[orderRows][2][count]": "5",
"order[orderRows][2][startDate][month]": "5",
"order[orderRows][2][startDate][day]": "18",
"order[orderRows][2][startDate][year]": "2015",
"order[orderRows][2][endDate][month]": "5",
"order[orderRows][2][endDate][day]": "18",
"order[orderRows][2][endDate][year]": "2015",
"order[orderRows][2][amount]": "35.5",
"order[orderRows][2][taxAmount]": "7.46",
"order[orderRows][2][discountAmount]": "0"
}

上面的请求会编辑订单详细信息并创建新的order_rows，因为未提供任何order_row_id。在Symfony2中的Nowere中，我发现我应该$builder->add（'id'）到我的OrderRowType，我的实体也没有列ID的设置器。

在了解了大量信息之后，我有一个非常简短的问题。我应该如何更新此表单中的order_rows记录？

答案 1

如果您不了解内部结构，处理集合和教义有时可能会很复杂。我将首先为您提供有关内部的一些信息，以便您更清楚地了解引擎盖下所做的工作。

很难从您提供的详细信息中估计实际问题，但我为您提供了一些可以帮助您调试问题的建议。我给出了一个广泛的答案，所以它可能会帮助别人。

TL;DR 版本

这是我的猜测：您正在通过引用修改实体，即使您设置为false。这可能是因为您没有定义和方法（两者），或者因为您没有使用教义集合对象by_referenceaddOrderRowremoveOrderRow

一些内部

形式

在控制器中创建 Form 对象时，将其与从数据库中检索到的实体（即使用 ID）或刚刚创建的实体绑定：这意味着 Form 不需要主实体的 ID，也不需要集合对象的 ID。为了方便起见，您可以将其添加到表单中，但如果您确实要确保它们是不可变的（例如带选项的类型）。hiddendisabled => true

创建集合表单时，Symfony 会自动为实体集合中已存在的每个实体创建一个子窗体;这就是为什么在操作中，您（应该）始终看到已经存在的集合元素的可编辑表单。entity/<id>/edit

和选项控制是否可以动态调整生成的子窗体的大小，方法是删除集合中的某些元素或添加新元素（请参阅类）。请注意，当您与javascript一起使用时，必须谨慎使用占位符：这是用于重新映射对象服务器端的实际值，因此，如果更改它，Form将在集合中创建一个新元素。allow_addallow_deleteResizeFormListenerprototype__prototype__key

学说

在教义中，你需要好好照顾映射和映射。一端是将保持与数据库的关联的实体，而反面是另一个实体。持久化时，端是唯一触发要保存的关系的侧。在对象修改期间保持两个关系同步是一种模型责任。owning sideinverse sideowningowning

在处理一对多关系时，一方是（例如，在你的情况下是s），而一方是一方。owningmanyOrderRowoneinverse

最后，应用程序需要显式标记要持久化的实体。关系的两边都可以标记为，以便所有通过关系可到达的实体也持久化。在此过程中，将自动保留所有新实体，并且（在标准配置中）更新所有“脏”实体。persist cascading

脏实体的概念在官方文档中得到了很好的解释。默认情况下，Doctrine 通过将每个属性与原始状态进行比较来自动检测更新的实体，并在刷新期间生成语句。如果为了提高性能（即）而明确了这一点，则必须手动保留所有实体，即使该关系被标记为级联。UPDATE@ChangeTrackingPolicy("DEFERRED_EXPLICIT")

另请注意，当从 DB 重新加载实体时，Doctrine 使用实例来处理集合，因此您需要使用 doctrine 集合接口来处理实体的集合。PersistenCollection

要检查的内容

总而言之，这里有一个（希望是完整的）清单，列出了要检查是否正确的集合更新的事项。

教义关系的两面都设置得当

所属侧和反向侧都应标记为级联持久（如果不是，控制器必须手动级联...不推荐，除非太慢）;
集合属性必须是的实现，而不是简单的数组;Doctrine\Common\Collection
模型必须在每次更改时相互更新，因此这意味着
集合对象不应按原样返回，以避免通过引用进行修改。

在您的情况下：

<?php

class Order
{
    /**
    * @var integer
    *
    * @ORM\Column(name="id", type="integer")
    * @ORM\Id
    * @ORM\GeneratedValue(strategy="AUTO")
    */
    private $id;

    /**
     * @var \Doctrine\Common\Collections\Collection
     * @ORM\OneToMany(targetEntity="OrderRow", mappedBy="Order", cascade={"persist"})
     */
    private $orderRows;

    public function __construct()
    {
        // this is required, as Doctrine will replace it by a PersistenCollection on load
        $this->orderRows = new \Doctrine\Common\Collections\ArrayCollection();
    }

    /**
     * Add order row
     *
     * @param  OrderRow $row
     */
    public function addOrderRow(OrderRow $row)
    {
        if (! $this->orderRows->contains($row))
            $this->orderRows[] = $row;

        $row->setOrder($this);
    }

    /**
     * Remove order row
     *
     * @param OrderRow $row
     */
    public function removeOrderRow(OrderRow $row)
    {
        $removed = $this->orderRows->removeElement($row);
        /*
        // you may decide to allow your domain to have spare rows, with order set to null
        if ($removed)
            $row->setOrder(null);
        */

        return $removed;
    }

    /**
     * Get order rows
     * @return OrderRow[]
     */
    public function getOrders()
    {
        // toArray prevent edit by reference, which breaks encapsulation
        return $this->orderRows->toArray();
    }
}

class OrderRows
{
    /**
     * @var integer
     *
     * @ORM\Column(name="id", type="integer")
     * @ORM\Id
     * @ORM\GeneratedValue(strategy="AUTO")
     */
    private $id;

    /**
     * @var Order
     * @ORM\ManyToOne(targetEntity="Order", inversedBy="orderRows", cascade={"persist"})
     * @ORM\JoinColumn(name="order_id, referencedColumnName="id", nullable=false)
     */
    private $order;


    /**
     * Set order
     *
     * @param  Order $order
     */
    public function setOrder(Order $order)
    {
        // avoid infinite loops addOrderRow -> setOrder -> addOrderRow
        if ($this->order === $order) {
            return;
        }

        if (null !== $this->order) {
            // see the comment above about spare order rows
            $this->order->removeOrderRow($this);
        }

        $this->order = $order;
    }

    /**
     * Get order
     *
     * @return Order
     */
    public function getOrder()
    {
        return $this->order;
    }
}

表单集合配置正确

确保订单未由表单公开（但在模板中包含路由器操作的正确参数）idGET
确保 OrderRow 不存在，因为模型类会自动更新order
确保设置为by_referencefalse
确保在类中定义了和addOrderRowremoveOrderRowOrder
加快调试速度，请确保不要直接返回集合Order::getOrderRows

下面是代码段：

class OrderType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder
            ->add('orderRows', 'collection', [
                'type'           => new OrderRowType(),
                'allow_add'      => true,  // without, new elements are ignored
                'allow_delete'   => true,  // without, deleted elements are not updated
                'by_reference'   => false, // hint Symfony to use addOrderRow and removeOrderRow
                                          // NOTE: both method MUST exist, or Symfony will ignore the option
            ])
        ;
    }
}

class OrderRowType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options)
    {
        $builder
            // ->add('order') NOT required, the model will handle the setting
            ->add('product', 'product_selector') // service
        ;
    }
}

控制者必须正确更新实体

确保表单创建正确;
如果使用，请确保 HTTP 方法与 Form 方法属性匹配Form::handleRequest
如果表单有效，请处理集合中已删除的元素
如果表单有效，请保留实体，然后刷新

在你的情况下，你应该有一个这样的动作：

public function updateAction(Request $request, $id)
{
    $em = $this->getDoctrine()->getManager();

    $order = $em->getRepository('YourBundle:Order')->find($id);

    if (! $order) {
        throw $this->createNotFoundException('Unable to find Order entity.');
    }

    $previousRows = $order->getOrderRows();

// is a PUT request, so make sure that <input type="hidden" name="_method" value="PUT" /> is present in the template
    $editForm = $this->createForm(new OrderType(), $order, array(
        'method' => 'PUT',
        'action' => $this->generateUrl('order_update', array('id' => $id))
    ));
    $editForm->handleRequest($request);

    if ($editForm->isValid()) {
        // removed rows = previous rows - current rows
        $rowsRemoved = array_udiff($previousRows, $order->getOrderRows(), function ($a, $b) { return $a === $b ? 0 : -1; });

        // removed rows must be deleted manually
        foreach ($rowsRemoved as $row) {
            $em->remove($row);
        }

        // if not cascading, all rows must be persisted as well
        $em->flush();
    }

    return $this->render('YourBundle:Order:edit.html.twig', array(
        'entity'      => $order,
        'edit_form'   => $editForm->createView(),
    ));
}

希望这有帮助！

答案 2

由于以下原因，我认为这是不可能的：

OrderRows仅由其id标识，因此为了使教义知道哪个实体实际更新了id，需要知道id。但是，您需要将OrderRow id添加为字段，您不希望这样做，因为这将允许更改不属于该订单的“外部”OrderRows。（无需复杂的权限检查）

解决方案是完全删除旧的OrderRows并插入新的OrderRows。插入已经工作：-）。

删除实体在说明书的“原则：确保数据库持久性”下进行了描述

只有一个小缺点：当订单更新时，OrderRows会获得新的ID。