购物车在电商场景中基本是必须的一个模块,本包是基于 [overtrue/laravel-shopping-cart] 进行扩展开发,主要实现了以下扩展:
- 购物车数据支持 Database 存储
- Item 增加 Model 属性返回。因为购物车可能是SPU或者SKU,因此直接通过 model 属性直接返回相关对象。
- 支持多 Guard. 商城购物车和导购购物车。
已经完成了 Session 和 Database 模式下的单元测试 可放心使用.
composer require yzh52521/think-shop-cart:~0.5
app\middleware.php
return [
// Session初始化
\think\middleware\SessionInit::class,
];
You can change data Storage in config/cart.php
file.
'storage' => \yzh52521\ShoppingCart\storage\DatabaseStorage::class,
'storage' => \yzh52521\ShoppingCart\storage\SessionStorage::class,
If you use Database Storage, you need to execute
发布配置文件和数据库迁移文件:
php think tauthz:publish
执行迁移工具(确保数据库配置信息正确):
php think migrate:run
这将创建名为 shopping_cart
的表。
Add a new item.
Item | null ShopCart::add(
string | int $id,
string $name,
int $quantity,
int | float $price
[, array $attributes = []]
);
example:
$row = ShopCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
// Item:
// id => 37
// name => 'Item name'
// qty => 5
// price => 100.00
// color => 'red'
// size => 'M'
// total => 500.00
// __raw_id => '8a48aa7c8e5202841ddaf767bb4d10da'
$rawId = $row->rawId();// get __raw_id
$row->qty; // 5
...
Update the specified item.
Item ShopCart::update(string $rawId, int $quantity);
Item ShopCart::update(string $rawId, array $arrtibutes);
example:
ShopCart::update('8a48aa7c8e5202841ddaf767bb4d10da', ['name' => 'New item name');
// or only update quantity
ShopCart::update('8a48aa7c8e5202841ddaf767bb4d10da', 5);
Get all the items.
Collection ShopCart::all();
example:
$items = ShopCart::all();
Get the specified item.
Item ShopCart::get(string $rawId);
example:
$item = ShopCart::get('8a48aa7c8e5202841ddaf767bb4d10da');
Remove the specified item by raw ID.
boolean ShopCart::remove(string $rawId);
example:
ShopCart::remove('8a48aa7c8e5202841ddaf767bb4d10da');
Clean Shopping Cart.
boolean ShopCart::destroy();
boolean ShopCart::clean(); // alias of destroy();
example:
ShopCart::destroy();// or Cart::clean();
Returns the total of all items.
int | float ShopCart::total(); // alias of totalPrice();
int | float ShopCart::totalPrice();
example:
$total = ShopCart::total();
// or
$total = ShopCart::totalPrice();
Return the number of rows.
int ShopCart::countRows();
example:
ShopCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
ShopCart::add(37, 'Item name', 1, 100.00, ['color' => 'red', 'size' => 'M']);
ShopCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
ShopCart::add(127, 'foobar', 15, 100.00, ['color' => 'green', 'size' => 'S']);
$rows = ShopCart::countRows(); // 2
Returns the quantity of all items
int ShopCart::count($totalItems = true);
$totalItems
: When false
,will return the number of rows.
example:
ShopCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
ShopCart::add(37, 'Item name', 1, 100.00, ['color' => 'red', 'size' => 'M']);
ShopCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
$count = ShopCart::count(); // 11 (5+1+5)
Search items by property.
Collection ShopCart::search(array $conditions);
example:
$items = ShopCart::search(['color' => 'red']);
$items = ShopCart::search(['name' => 'Item name']);
$items = ShopCart::search(['qty' => 10]);
bool ShopCart::isEmpty();
Specifies the associated model of item.
Cart ShopCart::associate(string $modelName);
session example:
ShopCart::associate('app\model\Goods');
$item = ShopCart::get('8a48aa7c8e5202841ddaf767bb4d10da');
$item->goods->name; // $item->goods is instanceof 'app\model\Goods'
database example:
ShopCart::associate('app\model\Goods');
ShopCart::name('web.12');
$item = ShopCart::get('8a48aa7c8e5202841ddaf767bb4d10da');
$item->goods->name; // $item->goods is instanceof 'app\model\Goods'
properties of yzh52521\ShoppingCart\Item
:
id
- your goods item ID.name
- Name of item.qty
- Quantity of item.price
- Unit price of item.total
- Total price of item.__raw_id
- Unique ID of row.__model
- Name of item associated Model.- ... custom attributes.
And methods:
rawId()
- Return the raw ID of item.
MIT