2. The Cart and CartItem¶

2.1. Cart¶

You can access the cart total value using the ->getTotal() method. The denormalized number of cart items is available via ->getTotalItems() method. Recalculation of totals can happen by calling ->calculateTotal() method, using the simplest possible math. It will also update the item totals. The carts have their expiration time - ->getExpiresAt() returns that time and ->incrementExpiresAt() sets it to +3 hours from now by default. The collection of items (Implementing the Doctrine\Common\Collections\Collection interface) can be obtained using the ->getItems().

2.2. CartItem¶

Just like for the cart, the total is available via the same method (->getTotal()), but the unit price is accessible using the ->getUnitPrice() Each item also can calculate its total, using the quantity (->getQuantity()) and the unit price. It also has a very important method called ->equals(CartItemInterface $item), which decides whether the items are “same” or not. If they are, it should return true, false otherwise. This is taken into account when adding an item to the cart. If the added item is equal to an existing one, their quantities are summed, but no new item is added to the cart. By default, it compares the ids, but for our example we would prefer to check the products. We can easily modify our CartItem entity to do that correctly.

<?php

// src/App/AppBundle/Entity/CartItem.php
namespace App/AppBundle/Entity;

use Sylius\Bundle\CartBundle\Model\CartItem as BaseCartItem;
use Sylius\Bundle\CartBundle\Model\CartItemInterface;

class CartItem extends BaseCartItem
{
    private $product;

    public function getProduct()
    {
        return $this->product;
    }

    public function setProduct(Product $product)
    {
        $this->product = $product;
    }

    public function equals(CartItemInterface $item)
    {
        return $this->product === $item->getProduct();
    }
}

If the user tries to add the same product twice or more, it will just sum the quantities, instead of adding duplicates to the cart.