Общая схема этого шага будет выглядеть следующим образом:

• Корзина будет представлена классом Cart, который будет отнаследован от класса lmbObject. Это наследование позволит использовать get-методы для получения данных при выводе содержимого корзины в шаблоне (зачем, будет пояснено чуть позже).
• Объект корзины мы будем хранить в сессии.
• Корзина будет содержать несохраненные экземпляры класса OrderLine (до момента отправки заказа)
• OrderLine будет содержать фабричный метод (factory method), который будет создавать объект OrderLine из объекта класса Product.
• Все управление корзиной будет осуществляться через контроллер CartController

Мы уже создали таблицу order_line в базе данных нашего приложения. Теперь нам потребуется класс OrderLine, объекты которого мы будем хранить в корзине.

<?php
class OrderLine extends lmbActiveRecord
{
  static function createForProduct($product)
  {
    $line = new OrderLine();
    $line->setProduct($product);
    $line->setQuantity(0);
    $line->setPrice($product->getPrice());
    return $line;
  }
 
  function increaseQuantity($amount = 1)
  {
    $this->setQuantity($this->getQuantity() + $amount);
  } 
 
  function getSumm()
  {
    return $this->getQuantity() * $this->getPrice();
  }
}

Когда пользователь будет добавлять товары в корзину, он будет указывать идентификатор товара Product. Нам необходимо будет создавать экземпляр OrderLine из объекта Product. Для этого мы добавим фабричный метод в класс OrderLine:

При создании OrderLine мы копируем цену товара. Это сделано для того, чтобы в будущем при изменении цены на товар, суммы наших прошлых заказов никак не менялись.

Когда покупатель будет добавлять один и тот же товар в корзину дважды, мы не будем создавать экземпляры OrderLine - вместо этого мы будем только увеличивать количество единиц товара. Для этого мы ввели метод OrderLine :: increaseQuantity($amount):

Ну и последний штрих - это метод getSumm(), который возвращает сумму за эту позицию заказа.

Пока с OrderLine мы закончили, но обязательно вернемся, когда дойдем по оформления заказа покупателя.

Класс Cart будет содержать список OrderLine, а также логику по добавлению элементов:

Файл shop/src/model/Cart.class.php:

<?php
lmb_require('limb/core/src/lmbObject.class.php');
lmb_require('src/model/OrderLine.class.php');
 
class Cart extends lmbObject
{
  protected $line_items = array();
 
  function addProduct($product)
  {
    $id = $product->getId();
 
    if(!isset($this->line_items[$id]))
      $this->line_items[$id] = OrderLine :: createForProduct($product);
 
    $this->line_items[$id]->increaseQuantity(1);
  }
 
  function getItems()
  {
    return $this->line_items;
  }
 
  function reset()
  {
    parent :: reset();
 
    $this->line_items = array();
  }
}

Для очистки корзины можно будет пользоваться методом Cart :: reset(), этот метод находится в классе lmbObject, но мы его переопределим вызвав метод родительского класса.

Скорее всего, нам потребуются методы для получения общей суммы и количества товарных позиций в корзине. Поэтому добавим методы getTotalSumm() и getItemsCount():

class Cart extends lmbObject
{
  [...]
  function getTotalSumm()
  {
    $result = 0;
    foreach($this->line_items as $item)
      $result += $item->getSumm();
    return $result;
  }
 
  function getItemsCount()
  {
    return sizeof($this->line_items);
  }
}

Этого вполне достаточно. Теперь можно перейти к контроллеру CartController.

Создадим самую базовую реализацию CartController. Контроллер будет содержать метод для инициализации корзины и получения ее из сессии, а также методы для действий:

• doAdd() - добавление товара в корзину
• doDisplay() - отображение содержимого товара
• doEmpty()- полная очистка корзины

Файл shop/src/controller/CartController.class.php:

<?php
 
class CartController extends lmbController
{
  function doDisplay()
  {
    $this->view->set('cart', $this->_getCart());
  }
 
  function doEmpty()
  {
    $cart = $this->_getCart();
    $cart->reset();
    $this->redirect();
  }
 
  function doAdd()
  {
    $product_id = $this->request->getInteger('id');
    try
    {
      $product = Product :: findById($product_id);
      $cart = $this->_getCart();
      $cart->addProduct($product);
      $this->flashMessage('Product "' . $product->getTitle() . '" added to your cart!');
    }
    catch(lmbARException $e)
    {
      $this->flashError('Wrong product!');
    }
 
    if(isset($_SERVER['HTTP_REFERER']))
      $this->redirect($_SERVER['HTTP_REFERER']);
    else
      $this->redirect();
  }
 
  protected function _getCart()
  {
    $session = $this->toolkit->getSession();
    if(!$cart = $session->get('cart'))
    {
      $cart = new Cart();
      $session->set('cart', $cart);
    }
 
    return $cart;
  }
}

Поясним некоторые моменты.

  [...]
    try
    {
      $product = lmbActiveRecord :: findById('Product', $product_id);
      $cart = $this->_getCart();
      $cart->addProduct($product);
      $this->flashMessage('Product "' . $product->getTitle() . '" added to your cart!');
    }
    catch(lmbARException $e)
    {
      $this->flashError('Wrong product!');
    }

lmbActiveRecord :: findById генерирует исключение, если объект с указанным идентификатором загрузить не удалось. Чтобы не отображать фатальную ошибку, мы ловим это исключение (класса lmbARException) и передаем в шаблон сообщение об ошибке (flashError()). Если продукт был добавлен в корзину нормально, тогда мы передаем в шаблон информационное сообщение (flashMessage()).

Для того, чтобы добавить товар в корзину нам для начала нужно добавить ссылку на это действие в шаблон product/display.phtml:

[...]
          Price:<b>${$item.price|number:2, '.', ' '}</b><br/>
          <a href="{{route_url params='controller:cart,action:add,id:{$item.id}'}}">Add to cart</a><br/>
[...]

Файл shop/template/cart/display.phtml:

<? $this->title ='Your Cart'; ?>
{{wrap with="front_page_layout.phtml" in="content"}}
 
<? if($this->cart->items_count) {?>
<p>Your cart contains {$#cart.items_count} items.</p>
 
{{list using="$#cart.items" parity="$parity"}}
<table cellpadding="0" cellspacing="0" class='list'>
  <thead>
  <tr>
    <th>Title</th>
    <th>Price</th>
    <th>Quantity</th>
    <th>Summ</th>
  </tr>
  </thead>
  {{list:item}}
  <tr class='{$parity}'>
   <td>{$item.product.title}</td>
   <td>${$item.price|number:2, '.',' '}</td>
   <td>{$item.quantity}</td>
   <td>${$item.summ|number:2, '.', ' '}</td>
  </tr>
  {{/list:item}}
</table>
{{/list}}
 
Total summ is : <b>${$#cart.total_summ|number:2, '.', ' '}</b>
<br/>
<a href="{{route_url params='action:empty'}}">Empty cart</a><br/>
<a href="{{route_url params='action:checkout'}}">Checkout</a>
 
<? } else { ?>
You cart is empty at the moment!
<? } ?>
{{/wrap}}

В методе CartController :: doDisplay() мы передали объект корзины в шаблон. Это значит, что корзина доступна в корневом контейнере данных. Этим мы и воспользовались.

Подробнее о передаче данных внутри MACRO-шаблонов

Попробуйте добавить несколько товаров при помощи панели управления и добавить их в корзину. Вы должны получить нечто следующее:

Теперь мы можем приступить к оформлению заказав и сохранению их в базе данных. Этот пункт нашего плана покажет, как lmbActiveRecord поддерживает работу с различными отношениями между объектами, например, один-ко-многим или много-ко-многим.

Следующий шаг: Шаг7. Оформление и сохранение заказа в базе данных.