README

ShoppingCart PHP类

ShoppingCart是一个简单的PHP包，提供了一种简单的购物车实现，存储在session中。

安装

Composer

您可以使用composer安装它

composer require lombervid/shoppingcart

使用方法

创建ShoppingCart类的实例。

use Lombervid\ShoppingCart\ShoppingCart;

$shoppingCart = new ShoppingCart();

添加项目

您可以通过调用方法add()并将Item实例作为参数传递来添加项目。

use Lombervid\ShoppingCart\Item;
use Lombervid\ShoppingCart\ShoppingCart;

$cart = new ShoppingCart();
$cart->add(new Item('1', 'Cake', 15.56));
$cart->add(new Item('15', 'Frappe', 5));

foreach ($cart->items() as $item) {
	// $item->id
	// $item->name
}

此时您的$cart->items()将如下所示

array:2 [▼
  1 => Lombervid\ShoppingCart\Item {#5 ▼
    -id: "1"
    -name: "Cake"
    -price: 15.56
  }
  15 => Lombervid\ShoppingCart\Item {#6 ▼
    -id: "15"
    -name: "Frappe"
    -price: 5.0
  }
]

为项目添加额外字段

您还可以为项目添加额外字段（如价格、名称等）。Item构造函数接收一个参数fields，它是一个包含以下结构的Array

[
    'field_name'   => 'field_value',
    'field_2_name' => 'field_2_value'
]

当您提供$fields参数时，数组中的每个字段都将添加到您的项目。

$fields = [
	'size'  => 'XL',
	'color' => 'blue'
];

$item = new Item('23', 'My Shirt', 2.5, fields: $fields);
$cart->add($item);

以上代码，您的$cart->items()将如下所示

array:1 [▼
  23 => Lombervid\ShoppingCart\Item {#5 ▼
    -id: "23"
    -name: "My Shirt"
    -price: 2.5
    -qty: 1
    -fields: array:2 [▼
      "size" => "XL"
      "color" => "blue"
    ]
  }
]

然后您可以像访问属性一样访问任何额外字段

foreach ($cart->items() as $item) {
    // $item->size
    // $item->color
}

删除项目

您可以通过调用方法remove($id)并传入项目的$id作为参数来从购物车中删除一个项目。

$cart->remove(23);

清空购物车

您可以通过调用方法clear()来清空购物车，该方法将删除购物车中的所有项目。

$shoppingCart->clear();

高级选项

ShoppingCart

购物车选项

它是一个array，默认值为

[
    'name'     => 'shopping_cart',
    'autosave' => true,
    'tax'      => 0,
    'shipping' => [
        'amount' => 0,
        'free'   => 0,
    ],
]

lombervid / shoppingcart

维护者

详细信息