构建销售模块

销售模块是我们将建立的一系列模块中的最后一个模块,以提供一个简单而实用的网店应用程序。我们将通过在目录上添加购物车和结账功能来实现。结账本身将最终使用前面章节中定义的发货和支付服务。这里的总体重点将是绝对的基础知识,因为真正的购物车应用程序将采用更强大的方法。然而,了解如何以简单的方式将所有的东西联系在一起,是为以后更强大的网店应用实现打开大门的第一步。

在本章中,我们将涉及销售模块的以下主题:

  • 要求
  • 依赖
  • 实施
  • 单元测试
  • 功能测试

要求

在前面的模块化网店App需求规范中给我们提供了一些与购物车和结账相关的线框。根据这些线框,我们可以推测我们需要创建什么样的实体才能实现功能。

以下是所需模块实体的清单:

  • Cart
  • Cart Item
  • Order
  • Order Item

购物车实体包括以下属性和它们的数据类型:

  • id: integer, auto-increment
  • customer_id: string
  • created_at: datetime
  • modified_at: datetime

购物车物品实体包括以下属性:

  • id: integer, auto-increment
  • cart_id: integer, 引用类别表id列的外键
  • product_id: integer, 引用产品表id列的外键
  • qty: string
  • unit_price: decimal
  • created_at: datetime
  • modified_at: datetime

订单实体包括以下属性:

  • id: integer, auto-increment
  • customer_id: integer,引用客户表id列的外键
  • items_price: decimal
  • shipment_price: decimal
  • total_price: decimal
  • status: string
  • customer_email: string
  • customer_first_name: string
  • customer_last_name: string
  • address_first_name: string
  • address_last_name: string
  • address_country: string
  • address_state: string
  • address_city: string
  • address_postcode: string
  • address_street: string
  • address_telephone: string
  • payment_method: string
  • shipment_method: string
  • created_at: datetime
  • modified_at: datetime

订单物品实体包括以下属性:

  • id: integer, auto-increment
  • sales_order_id: integer, 引用订单表id列的外键
  • product_id: integer, 引用产品表id列的外键
  • title: string
  • qty: int
  • unit_price: decimal
  • total_price: decimal
  • created_at: datetime
  • modified_at: datetime

除了只是添加这些实体和它们的CRUD页面,我们还需要覆盖一个核心模块服务,负责构建分类菜单和发售商品。

依赖

销售模块在整个代码中会有几个依赖关系。这些依赖关系是针对客户和目录模块的。

实施

我们先创建一个新的模块Foggyline\SalesBundle。我们在控制台的帮助下,运行以下命令:

  1. php bin/console generate:bundle --namespace=Foggyline/SalesBundle

该命令会触发一个交互式的过程,沿途向我们提出几个问题,如图所示:

构建销售模块 - 图1

完成后,app/AppKernel.phpapp/config/routing.yml文件会自动修改。AppKernel类的registerBundles方法被添加到$bundles数组下的下面一行:

  1. new Foggyline\PaymentBundle\FoggylineSalesBundle(),

routing.yml文件已经更新,加入了以下条目:

  1. foggyline_payment:
  2. resource: "@FoggylineSalesBundle/Resources/config/routing.xml"
  3. prefix: /

为了避免与核心应用代码发生冲突,我们需要将 prefix: / 改成 prefix: /sales/

创建购物车实体

让我们继续创建购物车实体。我们通过使用控制台来创建,如图所示:

  1. php bin/console generate:doctrine:entity

这将触发交互式生成器,如下图所示:

构建销售模块 - 图2

这将在 src/Foggyline/SalesBundle/ 目录下创建 Entity/Cart.phpRepository/CartRepository.php 文件。在这之后,我们需要更新数据库,通过运行下面的命令,使其拉入购物车实体:

  1. php bin/console doctrine:schema:update --force

有了Cart实体,我们可以继续生成CartItem实体。

创建购物车物品实体

让我们继续创建一个CartItem实体。我们使用现在著名的控制台命令来创建:

  1. php bin/console generate:doctrine:entity

这将触发交互式生成器,如下截图所示:

构建销售模块 - 图3

这将在 src/Foggyline/SalesBundle/ 目录下创建 Entity/CartItem.phpRepository/CartItemRepository.php。当自动生成完成后,我们需要返回并编辑CartItem实体,更新购物车字段关系如下:

  1. /**
  2. * @ORM\ManyToOne(targetEntity="Cart", inversedBy="items")
  3. * @ORM\JoinColumn(name="cart_id", referencedColumnName="id")
  4. */
  5. private $cart;

在这里,我们定义了所谓的双向的一对多关联。一对多关联中的外键被定义在多端,在本例中是CartItem实体。双向映射需要在OneToMany关联上使用mappedBy属性,在ManyToOne关联上使用inverseBy属性。本例中的OneToManyCart实体,所以我们回到src/Foggyline/SalesBundle/Entity/Cart.php文件,并添加以下内容:

  1. /**
  2. * @ORM\OneToMany(targetEntity="CartItem", mappedBy="cart")
  3. */
  4. private $items;
  5. public function __construct() {
  6. $this->items = new \Doctrine\Common\Collections\ArrayCollection();
  7. }

然后,我们需要更新数据库,通过运行以下命令,使其拉入CartItem实体:

  1. php bin/console doctrine:schema:update --force

有了CartItem实体,我们可以继续生成订单实体。

创建体订单实

让我们继续创建一个订单实体。我们通过使用控制台来创建,如图所示:

  1. php bin/console generate:doctrine:entity

如果我们试图提供FoggylineSalesBundle:Order作为实体的快捷方式名称,生成的输出将抛出一个错误,如下截图所示:

构建销售模块 - 图4

相反,我们将使用SensioGeneratorBundle:SalesOrder作为实体的快捷方式名称,并按照这里所示的生成器完成:

构建销售模块 - 图5

接下来是其余的客户信息相关字段。为了更好地了解情况,请看下面的截图:

构建销售模块 - 图6

之后是与订单地址相关的其他字段,如图所示:

构建销售模块 - 图7

值得注意的是,通常我们希望在它自己的表中提取地址信息,也就是让它成为自己的实体。然而,为了保持简单,我们将把它作为SalesOrder实体的一部分。

一旦完成,这将在 src/Foggyline/SalesBundle/ 目录下创建 Entity/SalesOrder.phpRepository/SalesOrderRepository.php 文件。在这之后,我们需要更新数据库,通过运行下面的命令,使其拉入SalesOrder实体:

  1. php bin/console doctrine:schema:update --force

有了SalesOrder实体,我们可以继续生成SalesOrderItem实体。

创建SalesOrderItem实体

让我们继续创建SalesOrderItem实体。我们通过使用下面的控制台命令来启动代码生成器:

  1. php bin/console generate:doctrine:entity

当被要求提供实体快捷方式名称时,我们提供FoggylineSalesBundle:SalesOrderItem,然后按照生成器字段定义,如下截图所示:

构建销售模块 - 图8

这将在 src/Foggyline/SalesBundle/目录下创建 Entity/SalesOrderItem.phpRepository/SalesOrderItemRepository.php 文件。当自动生成完成后,我们需要返回编辑SalesOrderItem实体来更新SalesOrder字段关系,如下所示:

  1. /**
  2. * @ORM\ManyToOne(targetEntity="SalesOrder", inversedBy="items")
  3. * @ORM\JoinColumn(name="sales_order_id", referencedColumnName="id")
  4. */
  5. private $salesOrder;
  6. /**
  7. * @ORM\OneToOne(targetEntity="Foggyline\CatalogBundle\Entity\Product")
  8. * @ORM\JoinColumn(name="product_id", referencedColumnName="id")
  9. */
  10. private $product;

在这里,我们定义了两种类型的关系。第一种,与$salesOrder相关,是一对多的双向关联,我们在CartCartItem实体中看到了这种关联。第二种,与$product有关,是单向的一对一的关联。之所以说是单向引用,是因为CartItem引用了Product,而Product不会引用CartItem,因为我们不想改变属于其他模块的东西。

我们仍然需要回到 src/Foggyline/SalesBundle/Entity/SalesOrder.php 文件,并添加以下内容:

  1. /**
  2. * @ORM\OneToMany(targetEntity="SalesOrderItem", mappedBy="salesOrder")
  3. */
  4. private $items;
  5. public function __construct() {
  6. $this->items = new \Doctrine\Common\Collections\ArrayCollection();
  7. }

然后,我们需要更新数据库,使其拉入SalesOrderItem实体,运行以下命令:

  1. php bin/console doctrine:schema:update --force

有了SalesOrderItem实体,我们就可以开始构建购物车和结账页面了。

覆盖add_to_cart_url服务

add_to_cart_url服务最初是在FoggylineCustomerBundle中用j假数据声明的。这是因为在销售功能可用之前,我们需要一种在产品上建立Add to Cart URL的方法。虽然肯定不是很理想,但这是一种可能的方式。

现在,我们将用销售模块中声明的服务覆盖该服务,以提供正确的添加到购物车的URL。我们首先在 src/Foggyline/SalesBundle/Resources/config/services.xml 中定义服务,在服务下添加以下服务元素,如下所示:

  1. <service id="foggyline_sales.add_to_cart_url" class="Foggyline\SalesBundle\Service\AddToCartUrl">
  2. <argument type="service" id="doctrine.orm.entity_manager"/>
  3. <argument type="service" id="router"/>
  4. </service>

然后我们创建src/Foggyline/SalesBundle/Service/AddToCartUrl.php,内容如下:

  1. namespace Foggyline\SalesBundle\Service;
  2. class AddToCartUrl
  3. {
  4. private $em;
  5. private $router;
  6. public function __construct(
  7. \Doctrine\ORM\EntityManager $entityManager,
  8. \Symfony\Bundle\FrameworkBundle\Routing\Router $router
  9. )
  10. {
  11. $this->em = $entityManager;
  12. $this->router = $router;
  13. }
  14. public function getAddToCartUrl($productId)
  15. {
  16. return $this->router->generate('foggyline_sales_cart_add', array('id' => $productId));
  17. }
  18. }

路由器服务在这里期待名为foggyline_sales_cart_add的路由,但它仍然不存在。我们通过在 src/Foggyline/SalesBundle/Resources/config/routing.xml 文件的 routes 元素下添加以下条目来创建路由,如下所示:

  1. <route id="foggyline_sales_cart_add" path="/cart/add/{id}">
  2. <default key="_controller">FoggylineSalesBundle:Cart:add</default>
  3. </route>

路由定义期望在src/Foggyline/SalesBundle/Controller/CarController.php文件中找到购物车控制器中的addAction函数,我们定义如下:

  1. namespace Foggyline\SalesBundle\Controller;
  2. use Symfony\Component\HttpFoundation\Request;
  3. use Symfony\Bundle\FrameworkBundle\Controller\Controller;
  4. class CartController extends Controller
  5. {
  6. public function addAction($id)
  7. {
  8. if ($customer = $this->getUser()) {
  9. $em = $this->getDoctrine()->getManager();
  10. $now = new \DateTime();
  11. $product = $em->getRepository('FoggylineCatalogBundle:Product')->find($id);
  12. // Grab the cart for current user
  13. $cart = $em->getRepository('FoggylineSalesBundle:Cart')->findOneBy(array('customer' => $customer));
  14. // If there is no cart, create one
  15. if (!$cart) {
  16. $cart = new \Foggyline\SalesBundle\Entity\Cart();
  17. $cart->setCustomer($customer);
  18. $cart->setCreatedAt($now);
  19. $cart->setModifiedAt($now);
  20. } else {
  21. $cart->setModifiedAt($now);
  22. }
  23. $em->persist($cart);
  24. $em->flush();
  25. // Grab the possibly existing cart item
  26. // But, lets find it directly
  27. $cartItem = $em->getRepository('FoggylineSalesBundle:CartItem')->findOneBy(array('cart' => $cart, 'product' => $product));
  28. if ($cartItem) {
  29. // Cart item exists, update it
  30. $cartItem->setQty($cartItem->getQty() + 1);
  31. $cartItem->setModifiedAt($now);
  32. } else {
  33. // Cart item does not exist, add new one
  34. $cartItem = new \Foggyline\SalesBundle\Entity\CartItem();
  35. $cartItem->setCart($cart);
  36. $cartItem->setProduct($product);
  37. $cartItem->setQty(1);
  38. $cartItem->setUnitPrice($product->getPrice());
  39. $cartItem->setCreatedAt($now);
  40. $cartItem->setModifiedAt($now);
  41. }
  42. $em->persist($cartItem);
  43. $em->flush();
  44. $this->addFlash('success', sprintf('%s successfully added to cart', $product->getTitle()));
  45. return $this->redirectToRoute('foggyline_sales_cart');
  46. } else {
  47. $this->addFlash('warning', 'Only logged in users can add to cart.');
  48. return $this->redirect('/');
  49. }
  50. }
  51. }

addAction方法中,有相当多的逻辑在进行。我们首先检查当前用户在数据库中是否已经有一个购物车条目;如果没有,我们就创建一个新的条目。然后我们添加或更新现有的购物车项目。

为了让我们新的add_to_cart服务实际覆盖Customermodule的服务,我们仍然需要添加一个编译器。我们通过定义src/Foggyline/SalesBundle/DependencyInjection/Compiler/OverrideServiceCompilerPass.php文件来实现,内容如下:

  1. namespace Foggyline\SalesBundle\DependencyInjection\Compiler;
  2. use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
  3. use Symfony\Component\DependencyInjection\ContainerBuilder;
  4. use Symfony\Component\DependencyInjection\Definition;
  5. class OverrideServiceCompilerPass implements CompilerPassInterface
  6. {
  7. public function process(ContainerBuilder $container)
  8. {
  9. // Override 'add_to_cart_url' service
  10. $container->removeDefinition('add_to_cart_url');
  11. $container->setDefinition('add_to_cart_url', $container->getDefinition('foggyline_sales.add_to_cart_url'));
  12. // Override 'checkout_menu' service
  13. // Override 'foggyline_customer.customer_orders' service
  14. // Override 'bestsellers' service
  15. // Pickup/parse 'shipment_method' services
  16. // Pickup/parse 'payment_method' services
  17. }
  18. }

稍后,我们将在这个文件中添加其余的覆盖。为了使add_to_cart服务覆盖生效,我们需要在src/Foggyline/SalesBundle/FoggylineSalesBundle.php文件的build方法中注册编译器传递,如下所示:

  1. public function build(ContainerBuilder $container)
  2. {
  3. parent::build($container);;
  4. $container->addCompilerPass(new OverrideServiceCompilerPass());
  5. }

覆盖现在应该是有效的,我们的销售模块现在应该提供有效的添加到购物车链接。

覆盖checkout_menu服务

客户模块中定义的结账菜单服务的目的很简单,就是提供一个链接到购物车和结账过程的第一步。由于当时不知道销售模块,Customer模块提供了一个假链接,我们现在将覆盖这个链接。

我们先在src/Foggyline/SalesBundle/Resources/config/services.xml文件的services元素下添加以下服务条目,具体如下:

  1. <service id="foggyline_sales.checkout_menu" class="Foggyline\SalesBundle\Service\CheckoutMenu">
  2. <argument type="service" id="doctrine.orm.entity_manager"/>
  3. <argument type="service" id="security.token_storage"/>
  4. <argument type="service" id="router"/>
  5. </service>

然后我们添加src/Foggyline/SalesBundle/Service/CheckoutMenu.php文件,内容如下:

  1. namespace Foggyline\SalesBundle\Service;
  2. class CheckoutMenu
  3. {
  4. private $em;
  5. private $token;
  6. private $router;
  7. public function __construct(
  8. \Doctrine\ORM\EntityManager $entityManager,
  9. $tokenStorage,
  10. \Symfony\Bundle\FrameworkBundle\Routing\Router $router
  11. )
  12. {
  13. $this->em = $entityManager;
  14. $this->token = $tokenStorage->getToken();
  15. $this->router = $router;
  16. }
  17. public function getItems()
  18. {
  19. if ($this->token
  20. && $this->token->getUser() instanceof \Foggyline\CustomerBundle\Entity\Customer
  21. ) {
  22. $customer = $this->token->getUser();
  23. $cart = $this->em->getRepository('FoggylineSalesBundle:Cart')->findOneBy(array('customer' => $customer));
  24. if ($cart) {
  25. return array(
  26. array('path' => $this->router->generate('foggyline_sales_cart'), 'label' =>sprintf('Cart (%s)', count($cart->getItems()))),
  27. array('path' => $this->router->generate('foggyline_sales_checkout'), 'label' =>'Checkout'),
  28. );
  29. }
  30. }
  31. return array();
  32. }
  33. }

服务需要两个路由,foggyline_sales_cartfoggyline_sales_checkout,所以我们需要修改src/Foggyline/SalesBundle/Resources/config/routing.xml,在其中添加以下路由定义:

  1. <route id="foggyline_sales_cart" path="/cart/">
  2. <default key="_controller">FoggylineSalesBundle:Cart:index</default>
  3. </route>
  4. <route id="foggyline_sales_checkout" path="/checkout/">
  5. <default key="_controller">FoggylineSalesBundle:Checkout:index</default>
  6. </route>

新添加的路由期待购物车和结账控制器。购物车控制器已经有了,所以我们只需要给它添加indexAction即可。此时,我们只需添加一个空的,如下所示:

  1. public function indexAction(Request $request)
  2. {
  3. }

同样,让我们创建一个src/Foggyline/SalesBundle/Controller/CheckoutController.php文件,内容如下:

  1. namespace Foggyline\SalesBundle\Controller;
  2. use Symfony\Component\HttpFoundation\Request;
  3. use Symfony\Bundle\FrameworkBundle\Controller\Controller;
  4. use Symfony\Component\Form\Extension\Core\Type\TextType;
  5. use Symfony\Component\Form\Extension\Core\Type\CountryType;
  6. class CheckoutController extends Controller
  7. {
  8. public function indexAction()
  9. {
  10. }
  11. }

稍后,我们将重新回到这两个indexAction方法,并添加适当的方法体实现。

为了结束服务覆盖,我们现在修改之前创建的src/Foggyline/SalesBundle/DependencyInjection/Compiler/OverrideServiceCompilerPass.php文件,将// Override 'checkout_menu' 服务注释替换为以下内容:

  1. $container->removeDefinition('checkout_menu');
  2. $container->setDefinition('checkout_menu', $container->getDefinition('foggyline_sales.checkout_menu'));

我们新定义的服务现在应该覆盖在客户模块中定义的服务,从而提供正确的结账和购物车(购物车计数中的项目)URL。

覆盖客户订单服务

foggyline_customer.customer_orders服务是为当前登录的客户提供以前创建的订单集合。客户模块为此定义了一个虚拟服务,这样我们就可以继续在我的账户页面下建立My Orders部分。现在我们需要覆盖这个服务,使其返回正确的订单。

我们首先在 src/Foggyline/SalesBundle/Resources/config/services.xml 文件的服务下添加以下服务元素,如下所示:

  1. <service id="foggyline_sales.customer_orders" class="Foggyline\SalesBundle\Service\CustomerOrders">
  2. <argument type="service" id="doctrine.orm.entity_manager"/>
  3. <argument type="service" id="security.token_storage"/>
  4. <argument type="service" id="router"/>
  5. </service>

然后我们添加src/Foggyline/SalesBundle/Service/CustomerOrders.php文件,内容如下:

  1. namespace Foggyline\SalesBundle\Service;
  2. class CustomerOrders
  3. {
  4. private $em;
  5. private $token;
  6. private $router;
  7. public function __construct(
  8. \Doctrine\ORM\EntityManager $entityManager,
  9. $tokenStorage,
  10. \Symfony\Bundle\FrameworkBundle\Routing\Router $router
  11. )
  12. {
  13. $this->em = $entityManager;
  14. $this->token = $tokenStorage->getToken();
  15. $this->router = $router;
  16. }
  17. public function getOrders()
  18. {
  19. $orders = array();
  20. if ($this->token
  21. && $this->token->getUser() instanceof \Foggyline\CustomerBundle\Entity\Customer
  22. ) {
  23. $salesOrders = $this->em->getRepository('FoggylineSalesBundle:SalesOrder')
  24. ->findBy(array('customer' => $this->token->getUser()));
  25. foreach ($salesOrders as $salesOrder) {
  26. $orders[] = array(
  27. 'id' => $salesOrder->getId(),
  28. 'date' => $salesOrder->getCreatedAt()->format('d/m/Y H:i:s'),
  29. 'ship_to' => $salesOrder->getAddressFirstName() . '' . $salesOrder->getAddressLastName(),
  30. ' 'order_total' => $salesOrder->getTotalPrice(),
  31. 'status' => $salesOrder->getStatus(),
  32. 'actions' => array(
  33. array(
  34. 'label' =>'Cancel',
  35. 'path' => $this->router->generate('foggyline_sales_order_cancel', array('id' => $salesOrder->getId()))
  36. ),
  37. array(
  38. 'label' =>'Print',
  39. 'path' => $this->router->generate('foggyline_sales_order_print', array('id' => $salesOrder->getId()))
  40. )
  41. )
  42. );
  43. }
  44. }
  45. return $orders;
  46. }
  47. }

路由生成方法期望找到两个路由,foggyline_sales_order_cancelfoggyline_sales_order_print,这两个路由还没有被创建。

让我们继续创建它们,在 src/Foggyline/SalesBundle/Resources/config/routing.xml 文件的路由元素下添加以下内容:

  1. <route id="foggyline_sales_order_cancel"path="/order/cancel/{id}">
  2. <default key="_controller">FoggylineSalesBundle:SalesOrder:cancel</default>
  3. </route>
  4. <route id="foggyline_sales_order_print" path="/order/print/{id}">
  5. <default key="_controller">FoggylineSalesBundle:SalesOrder:print</default>
  6. </route>

路由定义则期望定义SalesOrderController。由于我们的应用程序需要一个管理员用户才能列出和编辑订单,我们将使用下面的Symfony命令来自动生成销售订单的CRUD:

  1. php bin/console generate:doctrine:crud

当被要求提供实体快捷方式名称时,我们只需提供FoggylineSalesBundle:SalesOrder,然后继续,允许创建写操作。此时,我们已经为我们创建了几个文件,以及Sales bundle之外的一些条目。其中一个条目是app/config/routing.yml文件中的路由定义,如下所示:

  1. foggyline_sales_sales_order:
  2. resource: "@FoggylineSalesBundle/Controller/SalesOrderController.php"
  3. type: annotation

我们应该已经有一个foggyline_sales条目。不同的是 foggyline_sales 指向我们的 router.xml 文件,而新创建的 foggyline_sales_sales_order 指向新创建的 SalesOrderController。为了简单起见,我们可以同时保留它们。

自动生成器还在app/Resources/views/目录下创建了一个salesorder目录,我们需要把它移到我们的bundle中,作为src/Foggyline/SalesBundle/Resources/views/Default/salesorder/目录。

现在我们可以在 src/Foggyline/SalesBundle/Controller/SalesOrderController.php 文件中添加以下内容来处理打印和取消操作,具体如下:

  1. public function cancelAction($id)
  2. {
  3. if ($customer = $this->getUser()) {
  4. $em = $this->getDoctrine()->getManager();
  5. $salesOrder = $em->getRepository('FoggylineSalesBundle:SalesOrder')
  6. ->findOneBy(array('customer' => $customer, 'id' => $id));
  7. if ($salesOrder->getStatus() != \Foggyline\SalesBundle\Entity\SalesOrder::STATUS_COMPLETE) {
  8. $salesOrder->setStatus(\Foggyline\SalesBundle\Entity\SalesOrder::STATUS_CANCELED);
  9. $em->persist($salesOrder);
  10. $em->flush();
  11. }
  12. }
  13. return $this->redirectToRoute('customer_account');
  14. }
  15. public function printAction($id)
  16. {
  17. if ($customer = $this->getUser()) {
  18. $em = $this->getDoctrine()->getManager();
  19. $salesOrder = $em->getRepository('FoggylineSalesBundle:SalesOrder')
  20. ->findOneBy(array('customer' => $customer, 'id' =>$id));
  21. return $this->render('FoggylineSalesBundle:default:salesorder/print.html.twig', array(
  22. 'salesOrder' => $salesOrder,
  23. 'customer' => $customer
  24. ));
  25. }
  26. return $this->redirectToRoute('customer_account');
  27. }

cancelAction方法只是检查该订单是否属于当前登录的客户,如果属于,则允许更改订单状态。printAction方法只是加载订单,如果它属于当前登录的客户,并将其传递给print.html.twig模板。

然后我们创建src/Foggyline/SalesBundle/Resources/views/default/salesorder/print.html.twig模板,内容如下:

  1. {% block body %}
  2. <h1>Printing Order #{{ salesOrder.id }}</h1>
  3. {#<p>Just a dummy Twig dump of entire variable</p>#}
  4. {{ dump(salesOrder) }}
  5. {% endblock %}

显然,这只是一个简化的输出,我们可以根据自己的需要进一步定制。重要的是,我们已经把订单对象传给了我们的模板,现在可以从中提取任何需要的信息。

最后,我们用以下代码替换 src/Foggyline/SalesBundle/DependencyInjection/Compiler/OverrideServiceCompilerPass.php 文件中的 // Override 'foggyline_customer.customer_orders' 服务注释:

  1. $container->removeDefinition('foggyline_customer.customer_orders');
  2. $container->setDefinition('foggyline_customer.customer_orders', $container->getDefinition('foggyline_sales.customer_orders'));

这将使服务覆盖启动,并拉动我们刚才的所有变化。

覆盖最畅销服务

客户模块中定义的畅销品服务应该是为首页显示的畅销品功能提供虚拟数据。我们的想法是在商店中展示五种最畅销的产品。现在销售模块需要覆盖这个服务以提供正确的实现方式,实际销售的产品数量会影响到所展示的畅销产品的内容。

我们首先在 src/Foggyline/SalesBundle/Resources/config/services.xml 文件的 service 元素下添加以下定义:

  1. <service id="foggyline_sales.bestsellers" class="Foggyline\SalesBundle\Service\BestSellers">
  2. <argument type="service" id="doctrine.orm.entity_manager"/>
  3. <argument type="service" id="router"/>
  4. </service>

然后我们定义src/Foggyline/SalesBundle/Service/BestSellers.php文件,内容如下:

  1. namespace Foggyline\SalesBundle\Service;
  2. class BestSellers
  3. {
  4. private $em;
  5. private $router;
  6. public function __construct(
  7. \Doctrine\ORM\EntityManager $entityManager,
  8. \Symfony\Bundle\FrameworkBundle\Routing\Router $router
  9. )
  10. {
  11. $this->em = $entityManager;
  12. $this->router = $router;
  13. }
  14. public function getItems()
  15. {
  16. $products = array();
  17. $salesOrderItem = $this->em->getRepository('FoggylineSalesBundle:SalesOrderItem');
  18. $_products = $salesOrderItem->getBestsellers();
  19. foreach ($_products as $_product) {
  20. $products[] = array(
  21. 'path' => $this->router->generate('product_show', array('id' => $_product->getId())),
  22. 'name' => $_product->getTitle(),
  23. 'img' => $_product->getImage(),
  24. 'price' => $_product->getPrice(),
  25. 'id' => $_product->getId(),
  26. );
  27. }
  28. return $products;
  29. }
  30. }

在这里,我们要获取SalesOrderItemRepository类的实例,并对其调用getBestsellers方法。这个方法仍然没有被定义。我们将其添加到文件 src/Foggyline/SalesBundle/Repository/SalesOrderItemRepository.php 文件中,如下所示:

  1. public function getBestsellers()
  2. {
  3. $products = array();
  4. $query = $this->_em->createQuery('SELECT IDENTITY(t.product), SUM(t.qty) AS HIDDEN q
  5. FROM Foggyline\SalesBundle\Entity\SalesOrderItem t
  6. GROUP BY t.product ORDER BY q DESC')
  7. ->setMaxResults(5);
  8. $_products = $query->getResult();
  9. foreach ($_products as $_product) {
  10. $products[] = $this->_em->getRepository('FoggylineCatalogBundle:Product')
  11. ->find(current($_product));
  12. }
  13. return $products;
  14. }

在这里,我们使用Doctrine Query Language (DQL)来建立一个五个畅销产品的列表。最后,我们需要将src/Foggyline/SalesBundle/DependencyInjection/Compiler/OverrideServiceCompilerPass.php文件中的// Override 'bestsellers'服务注释替换为如下代码:

  1. $container->removeDefinition('bestsellers');
  2. $container->setDefinition('bestsellers', $container->getDefinition('foggyline_sales.bestsellers'));

通过覆盖畅销产品服务,我们将基于实际销量的畅销产品列表暴露出来,供其他模块取用。

创建购物车页面

购物车页面是客户通过 “添加到购物车 “按钮,从首页、分类页或产品页看到添加到购物车的产品列表的地方。我们之前创建了CartController和一个空的indexAction函数。现在我们继续编辑indexAction函数如下:

  1. public function indexAction()
  2. {
  3. if ($customer = $this->getUser()) {
  4. $em = $this->getDoctrine()->getManager();
  5. $cart = $em->getRepository('FoggylineSalesBundle:Cart')->findOneBy(array('customer' => $customer));
  6. $items = $cart->getItems();
  7. $total = null;
  8. foreach ($items as $item) {
  9. $total += floatval($item->getQty() * $item->getUnitPrice());
  10. }
  11. return $this->render('FoggylineSalesBundle:default:cart/index.html.twig', array(
  12. 'customer' => $customer,
  13. 'items' => $items,
  14. 'total' => $total,
  15. ));
  16. } else {
  17. $this->addFlash('warning', 'Only logged in customers can access cart page.');
  18. return $this->redirectToRoute('foggyline_customer_login');
  19. }
  20. }

在这里,我们检查用户是否已登录;如果用户已登录,我们将向他们展示购物车中的所有商品。未登录的用户会被重定向到客户登录的URL。indexAction函数期望得到src/Foggyline/SalesBundle/Resources/views/Default/art/index.html.twig文件,其内容我们定义如下:

  1. {% extends 'base.html.twig' %}
  2. {% block body %}
  3. <h1>Shopping Cart</h1>
  4. <div class="row">
  5. <div class="large-8 columns">
  6. <form action="{{ path('foggyline_sales_cart_update') }}"method="post">
  7. <table>
  8. <thead>
  9. <tr>
  10. <th>Item</th>
  11. <th>Price</th>
  12. <th>Qty</th>
  13. <th>Subtotal</th>
  14. </tr>
  15. </thead>
  16. <tbody>
  17. {% for item in items %}
  18. <tr>
  19. <td>{{ item.product.title }}</td>
  20. <td>{{ item.unitPrice }}</td>
  21. <td><input name="item[{{ item.id }}]" value="{{ item.qty }}"/></td>
  22. <td>{{ item.qty * item.unitPrice }}</td>
  23. </tr>
  24. {% endfor %}
  25. </tbody>
  26. </table>
  27. <button type="submit" class="button">Update Cart</button>
  28. </form>
  29. </div>
  30. <div class="large-4 columns">
  31. <div>Order Total: {{ total }}</div>
  32. <div><a href="{{ path('foggyline_sales_checkout') }}"class="button">Go to Checkout</a></div>
  33. </div>
  34. </div>
  35. {% endblock %}

渲染后,模板将在每个添加的产品下显示数量输入元素,同时显示更新购物车按钮。更新购物车按钮提交表单,其操作指向foggyline_sales_cart_update路径。

让我们继续创建foggyline_sales_cart_update,在src/Foggyline/SalesBundle/Resources/config/routing.xml文件的路由元素下添加以下条目,如下所示:

  1. <route id="foggyline_sales_cart_update" path="/cart/update">
  2. <default key="_controller">FoggylineSalesBundle:Cart:update</default>
  3. </route>

新定义的路由期望在 src/Foggyline/SalesBundle/Controller/CartController.php 文件下找到一个 updateAction 函数,我们添加如下:

  1. public function updateAction(Request $request)
  2. {
  3. $items = $request->get('item');
  4. $em = $this->getDoctrine()->getManager();
  5. foreach ($items as $_id => $_qty) {
  6. $cartItem = $em->getRepository('FoggylineSalesBundle:CartItem')->find($_id);
  7. if (intval($_qty) > 0) {
  8. $cartItem->setQty($_qty);
  9. $em->persist($cartItem);
  10. } else {
  11. $em->remove($cartItem);
  12. }
  13. }
  14. // Persist to database
  15. $em->flush();
  16. $this->addFlash('success', 'Cart updated.');
  17. return $this->redirectToRoute('foggyline_sales_cart');
  18. }

要从购物车中删除产品,我们只需插入0作为数量值,然后点击更新购物车按钮。这就完成了我们简单的购物车页面。

创建支付服务

为了从购物车转移到结账,我们需要整理出支付和发货服务。之前的 PaymentShipment 模块暴露了他们的一些 PaymentShipment 服务,现在我们需要将这些服务聚合成一个单一的 PaymentShipment 服务,以便我们的结账流程使用。

我们首先将之前添加的 // Pickup/parse 'payment_method' 服务注释替换到 src/Foggyline/SalesBundle/DependencyInjection/Compiler/OverrideServiceCompilerPass.php 文件下,代码如下:

  1. $container->getDefinition('foggyline_sales.payment')
  2. ->addArgument(
  3. array_keys($container->findTaggedServiceIds('payment_method'))
  4. );

findTaggedServiceIds方法返回一个key-value列表,其中包含了所有带有payment_method标签的服务,然后我们将其作为参数传递给foggyline_sales.payment服务。这是Symfony在编译过程中获取服务列表的唯一方法。

然后我们编辑src/Foggyline/SalesBundle/Resources/config/services.xml文件,在服务元素下添加以下内容:

  1. <service id="foggyline_sales.payment" class="Foggyline\SalesBundle\Service\Payment">
  2. <argument type="service" id="service_container"/>
  3. </service>

最后,我们在 src/Foggyline/SalesBundle/Service/Payment.php 文件中创建 Payment 类,如下所示:

  1. namespace Foggyline\SalesBundle\Service;
  2. class Payment
  3. {
  4. private $container;
  5. private $methods;
  6. public function __construct($container, $methods)
  7. {
  8. $this->container = $container;
  9. $this->methods = $methods;
  10. }
  11. public function getAvailableMethods()
  12. {
  13. $methods = array();
  14. foreach ($this->methods as $_method) {
  15. $methods[] = $this->container->get($_method);
  16. }
  17. return $methods;
  18. }
  19. }

按照services.xml文件中的服务定义,我们的服务接受两个参数,一个是$container,另一个是$methods$methods参数是在编译的时候传递的,在这里我们能够获取所有payment_method标签服务的列表。这意味着我们的getAvailableMethods现在能够从任何模块中返回所有payment_method标记的服务。

创建发货服务

发货服务的实现方式与支付服务大同小异。整体的想法是相似的,只是在方式上有一些不同。我们首先将之前在 src/Foggyline/SalesBundle/DependencyInjection/Compiler/OverrideServiceCompilerPass.php 文件下添加的 // Pickup/parse shipment_method' 服务注释替换为如下代码:

  1. $container->getDefinition('foggyline_sales.shipment')
  2. ->addArgument(
  3. array_keys($container->findTaggedServiceIds('shipment_method'))
  4. );

然后我们编辑 src/Foggyline/SalesBundle/Resources/config/services.xml 文件,在服务元素下添加以下内容:

  1. <service id="foggyline_sales.shipment"class="Foggyline\SalesBundle\Service\Payment">
  2. <argument type="service" id="service_container"/>
  3. </service>

最后,我们在 src/Foggyline/SalesBundle/Service/Shipment.php 文件中创建 Shipment 类,如下所示:

  1. namespace Foggyline\SalesBundle\Service;
  2. class Shipment
  3. {
  4. private $container;
  5. private $methods;
  6. public function __construct($container, $methods)
  7. {
  8. $this->container = $container;
  9. $this->methods = $methods;
  10. }
  11. public function getAvailableMethods()
  12. {
  13. $methods = array();
  14. foreach ($this->methods as $_method) {
  15. $methods[] = $this->container->get($_method);
  16. }
  17. return $methods;
  18. }
  19. }

我们现在能够通过统一的支付和发货服务获取所有的支付和发货服务,从而使结账过程变得简单。

创建结账页面

结账页面将由两个结账步骤构成,第一个步骤是发货信息收集,第二个步骤是支付信息收集。

我们先从发货步骤开始,将我们的src/Foggyline/SalesBundle/Controller/CheckoutController.php文件及其indexAction修改如下:

  1. public function indexAction()
  2. {
  3. if ($customer = $this->getUser()) {
  4. $form = $this->getAddressForm();
  5. $em = $this->getDoctrine()->getManager();
  6. $cart = $em->getRepository('FoggylineSalesBundle:Cart')->findOneBy(array('customer' => $customer));
  7. $items = $cart->getItems();
  8. $total = null;
  9. foreach ($items as $item) {
  10. $total += floatval($item->getQty() * $item->getUnitPrice());
  11. }
  12. return $this->render('FoggylineSalesBundle:default:checkout/index.html.twig', array(
  13. 'customer' => $customer,
  14. 'items' => $items,
  15. 'cart_subtotal' => $total,
  16. 'shipping_address_form' => $form->createView(),
  17. 'shipping_methods' => $this->get('foggyline_sales.shipment')->getAvailableMethods()
  18. ));
  19. } else {
  20. $this->addFlash('warning', 'Only logged in customers can access checkout page.');
  21. return $this->redirectToRoute('foggyline_customer_login');
  22. }
  23. }
  24. private function getAddressForm()
  25. {
  26. return $this->createFormBuilder()
  27. ->add('address_first_name', TextType::class)
  28. ->add('address_last_name', TextType::class)
  29. ->add('company', TextType::class)
  30. ->add('address_telephone', TextType::class)
  31. ->add('address_country', CountryType::class)
  32. ->add('address_state', TextType::class)
  33. ->add('address_city', TextType::class)
  34. ->add('address_postcode', TextType::class)
  35. ->add('address_street', TextType::class)
  36. ->getForm();
  37. }

在这里,我们要获取当前登录的客户购物车,并将其传递到一个checkout/index.html.twig模板上,同时还有发货步骤所需的其他几个变量。getAddressForm方法只是为我们构建了一个地址表单。还有一个向我们新创建的foggyline_sales.shipment服务的调用,它使我们能够获取所有可用的发货方式的列表。

然后我们创建src/Foggyline/SalesBundle/Resources/views/default/checkout/index.html.twig,内容如下:

  1. {% extends 'base.html.twig' %}
  2. {% block body %}
  3. <h1>Checkout</h1>
  4. <div class="row">
  5. <div class="large-8 columns">
  6. <form action="{{ path('foggyline_sales_checkout_payment') }}" method="post" id="shipping_form">
  7. <fieldset>
  8. <legend>Shipping Address</legend>
  9. {{ form_widget(shipping_address_form) }}
  10. </fieldset>
  11. <fieldset>
  12. <legend>Shipping Methods</legend>
  13. <ul>
  14. {% for method in shipping_methods %}
  15. {% set shipment = method.getInfo('street', 'city', 'country', 'postcode', 'amount', 'qty')['shipment'] %}
  16. <li>
  17. <label>{{ shipment.title }}</label>
  18. <ul>
  19. {% for delivery_option in shipment.delivery_options %}
  20. <li>
  21. <input type="radio" name="shipment_method"
  22. value="{{ shipment.code }}____{{ delivery_option.code }}____{{ delivery_option.price }}"> {{ delivery_option.title }}
  23. ({{ delivery_option.price }})
  24. <br>
  25. </li>
  26. {% endfor %}
  27. </ul>
  28. </li>
  29. {% endfor %}
  30. </ul>
  31. </fieldset>
  32. </form>
  33. </div>
  34. <div class="large-4 columns">
  35. {% include 'FoggylineSalesBundle:default:checkout/order_sumarry.html.twig'
  36. %}
  37. <div>Cart Subtotal: {{ cart_subtotal }}</div>
  38. <div><a id="shipping_form_submit" href="#" class="button">Next</a>
  39. </div>
  40. </div>
  41. </div>
  42. <script type="text/javascript">
  43. var form = document.getElementById('shipping_form');
  44. document.getElementById('shipping_form_submit').addEventListener('click', function () {
  45. form.submit();
  46. });
  47. </script>
  48. {% endblock %}

该模板列出了所有与地址相关的表单字段,以及可用的发货方式。JavaScript部分负责处理Next按钮的点击,这基本上是将表单提交到foggyline_sales_checkout_payment路由。

然后,我们通过在 src/Foggyline/SalesBundle/Resources/config/routing.xml 文件的 routes 元素下添加以下条目来定义 foggyline_sales_checkout_payment 路由:

  1. <route id="foggyline_sales_checkout_payment" path="/checkout/payment">
  2. <default key="_controller">FoggylineSalesBundle:Checkout:payment</default>
  3. </route>

路由条目期望在CheckoutController中找到一个paymentAction,我们定义如下:

  1. public function paymentAction(Request $request)
  2. {
  3. $addressForm = $this->getAddressForm();
  4. $addressForm->handleRequest($request);
  5. if ($addressForm->isSubmitted() && $addressForm->isValid() && $customer = $this->getUser()) {
  6. $em = $this->getDoctrine()->getManager();
  7. $cart = $em->getRepository('FoggylineSalesBundle:Cart')->findOneBy(array('customer' => $customer));
  8. $items = $cart->getItems();
  9. $cartSubtotal = null;
  10. foreach ($items as $item) {
  11. $cartSubtotal += floatval($item->getQty() * $item->getUnitPrice());
  12. }
  13. $shipmentMethod = $_POST['shipment_method'];
  14. $shipmentMethod = explode('____', $shipmentMethod);
  15. $shipmentMethodCode = $shipmentMethod[0];
  16. $shipmentMethodDeliveryCode = $shipmentMethod[1];
  17. $shipmentMethodDeliveryPrice = $shipmentMethod[2];
  18. // Store relevant info into session
  19. $checkoutInfo = $addressForm->getData();
  20. $checkoutInfo['shipment_method'] = $shipmentMethodCode . '____' . $shipmentMethodDeliveryCode;
  21. $checkoutInfo['shipment_price'] = $shipmentMethodDeliveryPrice;
  22. $checkoutInfo['items_price'] = $cartSubtotal;
  23. $checkoutInfo['total_price'] = $cartSubtotal + $shipmentMethodDeliveryPrice;
  24. $this->get('session')->set('checkoutInfo', $checkoutInfo);
  25. return $this->render('FoggylineSalesBundle:default:checkout/payment.html.twig', array(
  26. 'customer' => $customer,
  27. 'items' => $items,
  28. 'cart_subtotal' => $cartSubtotal,
  29. 'delivery_subtotal' => $shipmentMethodDeliveryPrice,
  30. 'delivery_label' =>'Delivery Label Here',
  31. 'order_total' => $cartSubtotal + $shipmentMethodDeliveryPrice,
  32. 'payment_methods' => $this->get('foggyline_sales.payment')->getAvailableMethods()
  33. ));
  34. } else {
  35. $this->addFlash('warning', 'Only logged in customers can access checkout page.');
  36. return $this->redirectToRoute('foggyline_customer_login');
  37. }
  38. }

前面的代码从结账过程的发货步骤中获取提交的内容,将相关的值存储到会话中,获取支付步骤所需的变量,并渲染回checkout/payment.html.twig模板。

我们定义src/Foggyline/SalesBundle/Resources/views/default/checkout/payment.html.twig文件,内容如下:

  1. {% extends 'base.html.twig' %}
  2. {% block body %}
  3. <h1>Checkout</h1>
  4. <div class="row">
  5. <div class="large-8 columns">
  6. <form action="{{ path('foggyline_sales_checkout_process') }}"method="post" id="payment_form">
  7. <fieldset>
  8. <legend>Payment Methods</legend>
  9. <ul>
  10. {% for method in payment_methods %}
  11. {% set payment = method.getInfo()['payment'] %}
  12. <li>
  13. <input type="radio" name="payment_method"
  14. value="{{ payment.code }}"> {{ payment.title }}
  15. {% if payment['form'] is defined %}
  16. <div id="{{ payment.code }}_form">
  17. {{ form_widget(payment['form']) }}
  18. </div>
  19. {% endif %}
  20. </li>
  21. {% endfor %}
  22. </ul>
  23. </fieldset>
  24. </form>
  25. </div>
  26. <div class="large-4 columns">
  27. {% include 'FoggylineSalesBundle:default:checkout/order_sumarry.html.twig' %}
  28. <div>Cart Subtotal: {{ cart_subtotal }}</div>
  29. <div>{{ delivery_label }}: {{ delivery_subtotal }}</div>
  30. <div>Order Total: {{ order_total }}</div>
  31. <div><a id="payment_form_submit" href="#" class="button">Place Order</a>
  32. </div>
  33. </div>
  34. </div>
  35. <script type="text/javascript">
  36. var form = document.getElementById('payment_form');
  37. document.getElementById('payment_form_submit').addEventListener('click', function () {
  38. form.submit();
  39. });
  40. </script>
  41. {% endblock %}

与发货步骤类似,我们在这里有一个可用的支付方式的渲染,同时还有一个 “下订单 “按钮,该按钮位于提交表单之外,由JavaScript处理。一旦订单被下达,POST提交就会进入foggyline_sales_checkout_process路由,我们在src/Foggyline/SalesBundle/Resources/config/routing.xml文件的路由元素中定义了如下路由:

  1. <route id="foggyline_sales_checkout_process"path="/checkout/process">
  2. <default key="_controller">FoggylineSalesBundle:Checkout:process</default>
  3. </route>

路径指向CheckoutController中的processAction函数,我们定义如下:

  1. public function processAction()
  2. {
  3. if ($customer = $this->getUser()) {
  4. $em = $this->getDoctrine()->getManager();
  5. // Merge all the checkout info, for SalesOrder
  6. $checkoutInfo = $this->get('session')->get('checkoutInfo');
  7. $now = new \DateTime();
  8. // Create Sales Order
  9. $salesOrder = new \Foggyline\SalesBundle\Entity\SalesOrder();
  10. $salesOrder->setCustomer($customer);
  11. $salesOrder->setItemsPrice($checkoutInfo['items_price']);
  12. $salesOrder->setShipmentPrice
  13. ($checkoutInfo['shipment_price']);
  14. $salesOrder->setTotalPrice($checkoutInfo['total_price']);
  15. $salesOrder->setPaymentMethod($_POST['payment_method']);
  16. $salesOrder->setShipmentMethod($checkoutInfo['shipment_method']);
  17. $salesOrder->setCreatedAt($now);
  18. $salesOrder->setModifiedAt($now);
  19. $salesOrder->setCustomerEmail($customer->getEmail());
  20. $salesOrder->setCustomerFirstName($customer->getFirstName());
  21. $salesOrder->setCustomerLastName($customer->getLastName());
  22. $salesOrder->setAddressFirstName($checkoutInfo['address_first_name']);
  23. $salesOrder->setAddressLastName($checkoutInfo['address_last_name']);
  24. $salesOrder->setAddressCountry($checkoutInfo['address_country']);
  25. $salesOrder->setAddressState($checkoutInfo['address_state']);
  26. $salesOrder->setAddressCity($checkoutInfo['address_city']);
  27. $salesOrder->setAddressPostcode($checkoutInfo['address_postcode']);
  28. $salesOrder->setAddressStreet($checkoutInfo['address_street']);
  29. $salesOrder->setAddressTelephone($checkoutInfo['address_telephone']);
  30. $salesOrder->setStatus(\Foggyline\SalesBundle\Entity\SalesOrder::STATUS_PROCESSING);
  31. $em->persist($salesOrder);
  32. $em->flush();
  33. // Foreach cart item, create order item, and delete cart item
  34. $cart = $em->getRepository('FoggylineSalesBundle:Cart')->findOneBy(array('customer' => $customer));
  35. $items = $cart->getItems();
  36. foreach ($items as $item) {
  37. $orderItem = new \Foggyline\SalesBundle\Entity\SalesOrderItem();
  38. $orderItem->setSalesOrder($salesOrder);
  39. $orderItem->setTitle($item->getProduct()->getTitle());
  40. $orderItem->setQty($item->getQty());
  41. $orderItem->setUnitPrice($item->getUnitPrice());
  42. $orderItem->setTotalPrice($item->getQty() * $item->getUnitPrice());
  43. $orderItem->setModifiedAt($now);
  44. $orderItem->setCreatedAt($now);
  45. $orderItem->setProduct($item->getProduct());
  46. $em->persist($orderItem);
  47. $em->remove($item);
  48. }
  49. $em->remove($cart);
  50. $em->flush();
  51. $this->get('session')->set('last_order', $salesOrder->getId());
  52. return $this->redirectToRoute('foggyline_sales_checkout_success');
  53. } else {
  54. $this->addFlash('warning', 'Only logged in customers can access checkout page.');
  55. return $this->redirectToRoute('foggyline_customer_login');
  56. }
  57. }

一旦POST提交点击控制器,一个包含所有相关项目的新订单就会被创建。同时,购物车和购物车中的物品也会被清空。最后,客户会被重定向到订单成功页面。

创建订单成功页面

订单成功页在完整的网络商店应用中具有重要作用。在这里,我们要感谢客户的购买,并可能提出一些更多相关或交叉相关的购物选项,以及一些可选的折扣。虽然我们的应用很简单,但值得构建一个简单的订单成功页面。

我们首先在 src/Foggyline/SalesBundle/Resources/config/routing.xml 文件的 routes 元素下添加以下路由定义:

  1. <route id="foggyline_sales_checkout_success" path="/checkout/success">
  2. <default key="_controller">FoggylineSalesBundle:Checkout:success</default>
  3. </route>

路径指向CheckoutController中的一个successAction函数,我们定义如下:

  1. public function successAction()
  2. {
  3. return $this->render('FoggylineSalesBundle:default:checkout/success.html.twig', array(
  4. 'last_order' => $this->get('session')->get('last_order')
  5. ));
  6. }

在这里,我们只是简单地获取当前登录客户最后创建的订单 ID,并将完整的订单对象传递给 src/Foggyline/SalesBundle/Resources/views/Default/checkout/success.html.twig 模板,如下所示:

  1. {% extends 'base.html.twig' %}
  2. {% block body %}
  3. <h1>Checkout Success</h1>
  4. <div class="row">
  5. <p>Thank you for placing your order #{{ last_order }}.</p>
  6. <p>You can see order details <a href="{{ path('customer_account') }}">here</a>.</p>
  7. </div>
  8. {% endblock %}

有了这个,我们就完成了网店的整个结账流程。虽然这是一个绝对简单的,但它为更强大的实现奠定了基础。

创建店长仪表盘

现在,我们已经敲定了结账销售模块,让我们快速回复到我们的核心模块—AppBundle。根据我们的应用需求,让我们继续创建一个简单的店长仪表盘。

我们先添加src/AppBundle/Controller/StoreManagerController.php文件,内容如下:

  1. namespace AppBundle\Controller;
  2. use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
  3. use Symfony\Bundle\FrameworkBundle\Controller\Controller;
  4. class StoreManagerController extends Controller
  5. {
  6. /**
  7. * @Route("/store_manager", name="store_manager")
  8. */
  9. public function indexAction()
  10. {
  11. return $this->render('AppBundle:default:store_manager.html.twig');
  12. }
  13. }

indexAction函数只是返回src/AppBundle/Resources/views/default/store_manager.html.twig文件,其内容我们定义如下:

  1. {% extends 'base.html.twig' %}
  2. {% block body %}
  3. <h1>Store Manager</h1>
  4. <div class="row">
  5. <div class="large-6 columns">
  6. <div class="stacked button-group">
  7. <a href="{{ path('category_new') }}" class="button">Add new Category</a>
  8. <a href="{{ path('product_new') }}" class="button">Add new Product</a>
  9. <a href="{{ path('customer_new') }}" class="button">Add new Customer</a>
  10. </div>
  11. </div>
  12. <div class="large-6 columns">
  13. <div class="stacked button-group">
  14. <a href="{{ path('category_index') }}" class="button">List & Manage Categories</a>
  15. <a href="{{ path('product_index') }}" class="button">List & Manage Products</a>
  16. <a href="{{ path('customer_index') }}" class="button">List & Manage Customers</a>
  17. <a href="{{ path('salesorder_index') }}" class="button">List & Manage Orders</a>
  18. </div>
  19. </div>
  20. </div>
  21. {% endblock %}

模板只是渲染了类别、产品、客户和订单管理的链接。这些链接的实际访问是由防火墙控制的,这在前面的章节中已经解释过。

单元测试

销售模块比之前的任何一个模块都要强大得多。有几件事我们可以进行单元测试。然而,我们不会把完整的单元测试作为本章的一部分。我们将简单地把注意力转向一个单一的单元测试,即CustomerOrders服务的单元测试。

我们首先在phpunit.xml.dist文件的testsuites元素下添加以下一行:

  1. <directory>src/Foggyline/SalesBundle/Tests</directory>

有了这些,从我们的商店根目录下运行phpunit命令,就可以在src/Foggyline/SalesBundle/Tests/目录下找到我们定义的测试。

现在,让我们继续为CustomerOrders服务创建一个测试。我们通过定义src/Foggyline/SalesBundle/Tests/Service/CustomerOrdersTest.php文件来进行测试,内容如下:

  1. namespace Foggyline\SalesBundle\Test\Service;
  2. use Symfony\Bundle\FrameworkBundle\Test\KernelTestCase;
  3. use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken;
  4. class CustomerOrdersTest extends KernelTestCase
  5. {
  6. private $container;
  7. public function setUp()
  8. {
  9. static::bootKernel();
  10. $this->container = static::$kernel->getContainer();
  11. }
  12. public function testGetOrders()
  13. {
  14. $firewall = 'foggyline_customer';
  15. $em = $this->container->get('doctrine.orm.entity_manager');
  16. $user = $em->getRepository('FoggylineCustomerBundle:Customer')->findOneByUsername
  17. ('ajzele@gmail.com');
  18. $token = new UsernamePasswordToken($user, null, $firewall, array('ROLE_USER'));
  19. $tokenStorage = $this->container->get('security.token_storage');
  20. $tokenStorage->setToken($token);
  21. $orders = new \Foggyline\SalesBundle\Service\CustomerOrders(
  22. $em,
  23. $tokenStorage,
  24. $this->container->get('router')
  25. );
  26. $this->assertNotEmpty($orders->getOrders());
  27. }
  28. }

这里,我们使用UsernamePasswordToken函数来模拟客户登录。然后,密码令牌被传递给CustomerOrders服务。然后CustomerOrders服务在内部检查令牌存储是否有分配的令牌,将其标记为已登录的用户并返回其订单列表。能够模拟客户登录对于我们可能为销售模块编写的任何其他测试都是至关重要的。

功能测试

与单元测试类似,我们将只关注单一功能测试,因为做任何更强大的测试都不在本章的范围内。我们将编写一段简单的代码,将商品添加到购物车中,并进入结账页面。为了将商品添加到购物车中,这里我们还需要模拟用户登录。

我们编写src/Foggyline/SalesBundle/Tests/Controller/CartControllerTest.php测试如下:

  1. namespace Foggyline\SalesBundle\Tests\Controller;
  2. use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
  3. use Symfony\Component\BrowserKit\Cookie;
  4. use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken;
  5. class CartControllerTest extends WebTestCase
  6. {
  7. private $client = null;
  8. public function setUp()
  9. {
  10. $this->client = static::createClient();
  11. }
  12. public function testAddToCartAndAccessCheckout()
  13. {
  14. $this->logIn();
  15. $crawler = $this->client->request('GET', '/');
  16. $crawler = $this->client->click($crawler->selectLink('Add to Cart')->link());
  17. $crawler = $this->client->followRedirect();
  18. $this->assertTrue($this->client->getResponse()->isSuccessful());
  19. $this->assertGreaterThan(0, $crawler->filter('html:contains("added to cart")')->count());
  20. $crawler = $this->client->request('GET', '/sales/cart/');
  21. $crawler = $this->client->click($crawler->selectLink('Go to Checkout')->link());
  22. $this->assertTrue($this->client->getResponse()->isSuccessful());
  23. $this->assertGreaterThan(0, $crawler->filter('html:contains("Checkout")')->count());
  24. }
  25. private function logIn()
  26. {
  27. $session = $this->client->getContainer()->get('session');
  28. $firewall = 'foggyline_customer'; // firewall name
  29. $em = $this->client->getContainer()->get('doctrine')->getManager();
  30. $user = $em->getRepository('FoggylineCustomerBundle:Customer')->findOneByUsername('ajzele@gmail.com');
  31. $token = new UsernamePasswordToken($user, null, $firewall, array('ROLE_USER'));
  32. $session->set('_security_' . $firewall, serialize($token));
  33. $session->save();
  34. $cookie = new Cookie($session->getName(), $session->getId());
  35. $this->client->getCookieJar()->set($cookie);
  36. }
  37. }

运行后,测试将模拟客户登录,向购物车中添加商品,并尝试进入结账页面。根据数据库中的实际客户情况,我们可能需要更改前面测试中提供的客户邮箱。

现在运行phpunit命令应该可以成功执行我们的测试。

小结

在本章中,我们构建了一个简单而实用的销售模块。只用四个简单的实体(Cart、CartItem、SalesOrder和SalesOrderItem),我们就实现了简单的购物车和结账功能。通过这样做,我们让客户实际进行购买,而不仅仅是浏览产品目录。销售模块使用了前面章节中定义的支付和发货服务。虽然支付和发货服务是作为虚拟的服务来实现的,但它们确实提供了一个基本的骨架,我们可以用来实现真正的支付和装运API。

此外,在这一章中,我们解决了管理员仪表板的问题,做了一个简单的接口,只是聚合了一些现有的CRUD接口。通过app/config/security.yml中的条目来保护对仪表盘和管理链接的访问,并且只允许ROLE_ADMIN访问。

到目前为止,所写的模块共同组成了一个简化的应用程序。编写健壮的网店应用程序通常会包括现代电子商务平台(如Magento)中发现的数十种其他功能。这些功能包括多种语言、货币和网站支持;强大的类别、产品和产品库存管理;购物车和目录销售规则;以及其他许多功能。模块化我们的应用程序使开发和维护过程变得更加容易。