如何在现有Symfony2应用程序中实现Sylius OrderBundle

Question

我需要在我的Symfony2应用程序来实现syliusOrderBundle，我看了他们的官方网站上的文档和重新http://docs.sylius.org/en/latest/bundles/SyliusOrderBundle/installation.html 我已经结束了安装和启用以下捆绑

      new Sylius\Bundle\ResourceBundle\SyliusResourceBundle(),
        new Sylius\Bundle\MoneyBundle\SyliusMoneyBundle(),
        new Sylius\Bundle\OrderBundle\SyliusOrderBundle(),
        new Sylius\Bundle\CartBundle\SyliusCartBundle(),
        new Sylius\Bundle\ProductBundle\SyliusProductBundle(),
        new Sylius\Bundle\ArchetypeBundle\SyliusArchetypeBundle(),
        new Sylius\Bundle\AttributeBundle\SyliusAttributeBundle(),
        new Sylius\Bundle\AssociationBundle\SyliusAssociationBundle(),
        new Sylius\Bundle\VariationBundle\SyliusVariationBundle(),

由于安全原因，问题在于用户不愿意安装不必要的捆绑软件，而sylius文档无济于事。我需要做的就是，如果您以前曾使用过产品，可以将其添加到订单中。谢谢

Answer 1

首先，您需要的只是sylius/order-bundle0.17版（在撰写本文时）

$ composer require sylius/order-bundle "^0.17"

然后将必要的捆绑包添加到app/AppKernel.php：

public function registerBundles()
{
    $bundles = [
        // Bundles you've already registered go here.

        // The following bundles are dependencies of Sylius ResourceBundle.
        new FOS\RestBundle\FOSRestBundle(),
        new JMS\SerializerBundle\JMSSerializerBundle($this),
        new Stof\DoctrineExtensionsBundle\StofDoctrineExtensionsBundle(),
        new WhiteOctober\PagerfantaBundle\WhiteOctoberPagerfantaBundle(),

        // The following Sylius bundles are dependencies of Sylius OrderBundle 
        new Sylius\Bundle\ResourceBundle\SyliusResourceBundle(),
        new Sylius\Bundle\MoneyBundle\SyliusMoneyBundle(),
        new Sylius\Bundle\SequenceBundle\SyliusSequenceBundle(),

        new Sylius\Bundle\OrderBundle\SyliusOrderBundle(),

        // Doctrine bundle MUST be the last bundle registered.

        new Doctrine\Bundle\DoctrineBundle\DoctrineBundle(),
    ];

    //....

    return $bundles;
}

现在要将OrderBundle与您自己的实体一起使用，您需要创建一个Order和OrderItem实体，以扩展Sylius提供的实体。

对于Order，我们将添加一个字段以捕获访问者的电子邮件地址。您可以捕获当前用户，也可以捕获任何喜欢的人来确定谁下订单。

<?php

namespace AppBundle\Entity;

use Sylius\Component\Order\Model\Order as SyliusOrder;

class Order extends SyliusOrder
{
    /**
     * @var string
     */
    private $email;

    /**
     * @return string
     */
    public function getEmail()
    {
        return $this->email;
    }

    /**
     * @param string $email
     */
    public function setEmail($email)
    {
        $this->email = $email;
    }
}

为了演示的目的，我们假设访问者要订购音乐曲目以进行下载。

否则，这可以是任何事情。在Sylius应用程序中，它是一个产品。在某些应用中，它可能不是产品，而是订阅或服务等。

因此，对于OrderItem，我们将添加一个字段以捕获访客将订购的下载。

<?php

namespace AppBundle\Entity;

use Sylius\Component\Order\Model\OrderItem as SyliusOrderItem;

class OrderItem extends SyliusOrderItem
{
    /**
     * @var Download
     */
    private $download;

    /**
     * @return Download
     */
    public function getDownload()
    {
        return $this->download;
    }

    /**
     * @param Download $download
     */
    public function setDownload(Download $download)
    {
        $this->download = $download;
    }
}

现在有了您的实体，您可以添加“教义”映射。在此示例中，我们使用XML（难看，但它会验证配置），但它可以是YAML或注释。

在src/AppBundle/Resources/config/doctrine/Order.orm.xml：

<?xml version="1.0" encoding="UTF-8"?>

<doctrine-mapping xmlns="http://doctrine-project.org/schemas/orm/doctrine-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://doctrine-project.org/schemas/orm/doctrine-mapping
        http://doctrine-project.org/schemas/orm/doctrine-mapping.xsd">

<entity name="AppBundle\Entity\Order" table="app_order">
    <field name="email" column="email" type="string" nullable="true" />

    <one-to-many field="items" target-entity="Sylius\Component\Order\Model\OrderItemInterface" mapped-by="order" orphan-removal="true">
        <cascade>
            <cascade-all/>
        </cascade>
    </one-to-many>

    <one-to-many field="adjustments" target-entity="Sylius\Component\Order\Model\AdjustmentInterface" mapped-by="order" orphan-removal="true">
        <cascade>
            <cascade-all/>
        </cascade>
    </one-to-many>
</entity>

在src/AppBundle/Resources/config/doctrine/OrderItem.orm.xml：

<?xml version="1.0" encoding="UTF-8"?>

<doctrine-mapping xmlns="http://doctrine-project.org/schemas/orm/doctrine-mapping"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://doctrine-project.org/schemas/orm/doctrine-mapping
         http://doctrine-project.org/schemas/orm/doctrine-mapping.xsd">

    <entity name="AppBundle\Entity\OrderItem" table="app_order_item">
        <many-to-one field="download" target-entity="AppBundle\Entity\Download">
            <join-column name="download_id" referenced-column-name="id" nullable="false" />
        </many-to-one>

    </entity>

</doctrine-mapping>

然后，我们需要让Sylius OrderBundle知道我们的新实体，以便它不使用其默认实体。

另外，我们想为我们的Order实体生成订单号，这由Sylius SequenceBundle完成。

在中app/config/config.yml，添加以下配置：

sylius_sequence:
    generators:
        AppBundle\Entity\Order: sylius.sequence.sequential_number_generator

sylius_order:
    resources:
        order:
            classes:
                model: AppBundle\Entity\Order
        order_item:
            classes:
                model: AppBundle\Entity\OrderItem

然后更新您的数据库架构：

$ php app/console doctrine:schema:update --dump-sql --force

现在，要使订单号实际生成并Order在持久化新实体时将其分配给，我们需要注册一个侦听器。

在app/config/services.yml您包的或中Resources/config/services.yml，添加以下配置：

parameters:
  sylius.model.sequence.class: Sylius\Component\Sequence\Model\Sequence

services:
  app.order_number_listener:
    class: Sylius\Bundle\OrderBundle\EventListener\OrderNumberListener
    arguments:
      - "@sylius.sequence.doctrine_number_listener"
    tags:
      - { name: kernel.event_listener, event: app.download_ordered, method: generateOrderNumber }

活动的名称在app.download_ordered这里很重要，您可以随意命名，但是在创建新订单时必须将其分派。

这是创建新订单的示例，我们在该订单中调度app.download_ordered事件。

    use AppBundle\Entity\Download;
    use AppBundle\Entity\OrderItem;
    use AppBundle\Form\OrderType;
    use Sensio\Bundle\FrameworkExtraBundle\Configuration as Framework;
    use AppBundle\Entity\Order;
    use Symfony\Bundle\FrameworkBundle\Controller\Controller;
    use Symfony\Component\EventDispatcher\GenericEvent;
    use Symfony\Component\HttpFoundation\Request;

    const STATE_BEGIN    = 'begin';
    const STATE_COMPLETE = 'complete';

    /**
     * @Framework\Route("/begin-order-for-download/{id}", name="begin_order_for_download")
     */
    public function beginOrderForDownloadAction(Request $request, $id)
    {
        $download = $this->getDoctrine()->getRepository(Download::class)->findOneBy(['id' => $id]);

        $order = new Order();
        $form = $this->createForm(new OrderType(), $order);

        if ('POST' === $request->getMethod()) {
            $order->setState(self::STATE_BEGIN);

            $orderItem = new OrderItem();
            $orderItem->setDownload($download);
            $orderItem->setOrder($order);
            $orderItem->setUnitPrice(59);
            // $orderItem->setImmutable(true); // Need to verify how this affects behavior.

            $this->get('event_dispatcher')->dispatch('app.download_ordered', new GenericEvent($order));

            $form->handleRequest($request);

            $em = $this->getDoctrine()->getManager();

            if ($form->isValid()) {
                $order->setState(self::STATE_COMPLETE);
                $this->addFlash('order.state', self::STATE_COMPLETE);

                $em->persist($order);
                $em->flush();

                return $this->redirectToRoute('complete_order', [
                    'id' => $order->getId(),
                ]);
            }
        }

        return $this->render('AppBundle::begin_order_for_download.html.twig', [
            'form'     => $form->createView(),
            'download' => $download,
        ]);
    }

该OrderType形式如下，保持简单的演示目的。根据您的需要进行编辑。

    <?php

    namespace AppBundle\Form;

    use Symfony\Component\Form\AbstractType;
    use Symfony\Component\Form\FormBuilderInterface;

    class OrderType extends AbstractType
    {
        /**
         * {@inheritdoc}
         */
        public function getName()
        {
            return 'order';
        }

        /**
         * {@inheritdoc}
         */
        public function buildForm(FormBuilderInterface $builder, array $options)
        {
            $builder->add('email', 'repeated', [
                'type'            => 'email',
                'first_options'   => ['label' => 'Email'],
                'second_options'  => ['label' => 'Repeat Email'],
                'invalid_message' => 'The email fields must match.',
            ]);
            $builder->add('proceed', 'submit', ['attr' => ['class' => 'button']]);
        }
    }

如果表单有效，我们的订单将保留下来，而侦听器为其分配一个订单号，那么我们将重新complete_order路由。在这里，您可以执行诸如提供付款细节的操作，或者在这种情况下，提供下载歌曲的链接。

而已。您可以在https://github.com/adamelso/orda上看到完整示例的代码。