Sylius/docs/bundles/SyliusCartBundle/services.rst

Using the services
==================

When using the bundle, you have access to several handy services.
You can use them to manipulate and manage the cart.

Managers and Repositories
-------------------------

.. note::

    Sylius uses ``Doctrine\Common\Persistence`` interfaces.

You have access to following services which are used to manage and retrieve resources.

This set of default services is shared across almost all Sylius bundles, but this is just a convention.
You're interacting with them like you usually do with own entities in your project.

.. code-block:: php

    <?php

    // ...
    public function saveAction(Request $request)
    {
        // ObjectManager which is capable of managing the Cart resource.
        // For *doctrine/orm* driver it will be EntityManager.
        $this->get('sylius.manager.cart');

        // ObjectRepository for the Cart resource, it extends the base EntityRepository.
        // You can use it like usual entity repository in project.
        $this->get('sylius.repository.cart');

        // Same pair for CartItem resource.
        $this->get('sylius.manager.cart_item');
        $this->get('sylius.repository.cart_item');

        // Those repositories have some handy default methods, for example...
        $item = $this->get('sylius.repository.cart')->createNew();
    }

Provider
--------

There is also 1 more service for you.

You use the provider to obtain the current user cart, if there is none, a new one is created and saved.
The ``->setCart()`` method also allows you to replace the current cart.
``->abandonCart()`` is resetting the current cart, a new one will be created on the next ``->getCart()`` call.
This is useful, for example, when after completing an order you want to start with a brand new and clean cart.

.. code-block:: php

    <?php

    // ...
    public function saveAction(Request $request)
    {
        $provider = $this->get('sylius.cart_provider'); // Implements the CartProviderInterface.

        $currentCart = $provider->getCart();
        $provider->setCart($customCart);
        $provider->abandonCart();
    }