README

此扩展是对omnilight/yii2-shopping-cart的改进。它为Yii框架2.0添加了购物车系统。它支持将购物车数据保存到多种介质，包括会话（默认）、cookie、localStorage、数据库和多种存储。

什么是多种存储？这是指可以处理两种存储方式的功能，即如果用户是访客，则将购物车数据保存到存储1，如果是已登录用户，则保存到存储2。

安装

安装此扩展的首选方式是通过 composer。

运行以下命令：

php composer.phar require --prefer-dist dvoiced/yii2-cart "*"

或者将以下内容添加到您的composer.json文件中的require部分：

"dvoiced/yii2-cart": "*"

如果您计划将购物车数据保存到数据库中，则应创建cart表。

CREATE TABLE `cart` (
  `id` varchar(255) NOT NULL,
  `user_id` int(11) DEFAULT NULL,
  `name` varchar(255) NOT NULL,
  `value` text NOT NULL,
  `status` tinyint(1) NOT NULL DEFAULT '0'
) ENGINE=InnoDB DEFAULT CHARSET=utf8;
ALTER TABLE `cart`
  ADD PRIMARY KEY (`id`);

或使用迁移

yii migrate --migrationPath=@hscstudio/cart/migrations

使用方法

在您的模型中

class Product extends ActiveRecord implements ItemInterface
{
    use ItemTrait;

    public function getPrice()
    {
        return $this->price;
    }

    public function getId()
    {
        return $this->id;
    }
}

在您的控制器中

	public function actionCreate($id)
    {
        $product = Product::findOne($id);
        if ($product) {
            \Yii::$app->cart->create($product);
            $this->redirect(['index']);
        }
    }
    public function actionIndex()
    {
        $cart = \Yii::$app->cart;
        $products = $cart->getItems();
        $total = $cart->getCost();
        return $this->render('index', [
            'products' => $products,
            'total' => $total,
        ]);
    }
    public function actionDelete($id)
    {
        $product = Product::findOne($id);
        if ($product) {
            \Yii::$app->cart->delete($product);
            $this->redirect(['index']);
        }
    }
    public function actionUpdate($id, $quantity)
    {
        $product = Product::findOne($id);
        if ($product) {
            \Yii::$app->cart->update($product, $quantity);
            $this->redirect(['index']);
        }
    }
	
	public function actionCheckout(){
		\Yii::$app->cart->checkOut(false);
		$this->redirect(['index']);
	}

您还可以将购物车作为全局应用程序组件使用

[
    'components' => [
        'cart' => [
			'class' => 'hscstudio\cart\Cart',
		],
    ]
]

存储的可能值

• hscstudio\cart\CookieStorage
• hscstudio\cart\SessionStorage
• hscstudio\cart\LocalStorage
• hscstudio\cart\DatabaseStorage
• hscstudio\cart\MultipleStorage

MultipleStorage的配置示例。

[
    'components' => [
        'cart' => [
			'class' => 'hscstudio\cart\Cart',
			'storage' => [
				'class' => 'hscstudio\cart\MultipleStorage',
				'storages' => [
					['class' => 'hscstudio\cart\SessionStorage'],
					[
						'class' => 'hscstudio\cart\DatabaseStorage',
						'table' => 'cart',
					],
				],
			]
		],
    ]
]

如果您使用Multiple Storage，则应在配置文件中添加bootstrap

    'bootstrap' => [
		...
		'hscstudio\cart\CartBootstrap'
	],

或者您可以创建并使用自己的storageClass，它应该扩展hscstudio\cart\Storage的抽象类。它看起来像这样

<?php

namespace app\foo;

use hscstudio\cart\Storage;

class ExampleStorage extends Storage
{
	public function read(Cart $cart)
	{
		// read cart data
	}
	
	public function write(Cart $cart)
	{
		// write cart data
	}
	
	public function lock($drop, Cart $cart)
	{
		// lock cart data, only for db
	}
}

以下是如何使用它的示例

\Yii::$app->cart->create($product, 1);

为了获取购物车中的项目数量

$itemsCount = \Yii::$app->cart->getCount();

为了获取购物车中项目的总成本

$total = \Yii::$app->cart->getCost();

如果用户完成购物并结账，可以使用以下代码

\Yii::$app->cart->removeAll(); // will remove data
// or 
\Yii::$app->cart->checkOut(); // will remove data
// or
\Yii::$app->cart->checkOut(false); // will keep data, only update status to 1 and regenerate session ID

使用折扣

折扣作为附加到购物车或其项目的行为实现。要使用它们，请按照以下步骤操作

1. 将折扣类定义为hscstudio\cart\DiscountBehavior的子类

// app/components/MyDiscount.php

class MyDiscount extends DiscountBehavior
{
    /**
     * @param CostCalculationEvent $event
     */
    public function onCostCalculation($event)
    {
        // Some discount logic, for example
        $event->discountValue = 100;
    }
}

1. 将此行为添加到购物车中

$cart->attachBehavior('myDiscount', ['class' => 'app\components\MyDiscount']);

如果折扣不适用于整个购物车，而是适用于单个项目，则可以将折扣附加到购物车位置本身

$cart->getItemById($itemId)->attachBehavior('myDiscount', ['class' => 'app\components\MyDiscount']);

注意，同一行为可以用于购物车和项目类。

1. 获取应用折扣后的总成本

$total = \Yii::$app->cart->getCost(true);

1. 在计算过程中会触发以下事件

• Cart::EVENT_COST_CALCULATION 每次计算时触发一次。
• ItemInterface::EVENT_COST_CALCULATION 为购物车中的每个项目触发。

您还可以订阅这些事件以执行折扣计算

$cart->on(Cart::EVENT_COST_CALCULATION, function ($event) {
    $event->discountValue = 100;
});