miyaye/laravel-shopping-cart

Laravel应用的购物车。

v1.0.2 2019-07-22 08:01 UTC

This package is auto-updated.

Last update: 2024-09-22 20:01:13 UTC


README

Laravel应用购物车 222。

Build Status Latest Stable Version Latest Unstable Version Scrutinizer Code Quality Code Coverage Total Downloads License

安装

$ composer require "overtrue/laravel-shopping-cart:~2.0"

或者将以下行添加到项目的 composer.json

"require": {
    "overtrue/laravel-shopping-cart": "~2.0"
}

然后

$ composer update

完成以上步骤后,将以下行添加到 config/app.php 文件的 providers 部分

Overtrue\LaravelShoppingCart\ServiceProvider::class,

并将以下行添加到 aliases 部分

'ShoppingCart'      => Overtrue\LaravelShoppingCart\Facade::class,

用法

添加商品到购物车

添加一个新的商品。

Item | null ShoppingCart::add(
                    string | int $id,
                    string $name,
                    int $quantity,
                    int | float $price
                    [, array $attributes = []]
                 );

示例

$row = ShoppingCart::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
...

更新商品

更新指定的商品。

Item ShoppingCart::update(string $rawId, int $quantity);
Item ShoppingCart::update(string $rawId, array $arrtibutes);

示例

ShoppingCart::update('8a48aa7c8e5202841ddaf767bb4d10da', ['name' => 'New item name');
// or only update quantity
ShoppingCart::update('8a48aa7c8e5202841ddaf767bb4d10da', 5);

获取所有商品

获取所有商品。

Collection ShoppingCart::all();

示例

$items = ShoppingCart::all();

获取商品

获取指定的商品。

Item ShoppingCart::get(string $rawId);

示例

$item = ShoppingCart::get('8a48aa7c8e5202841ddaf767bb4d10da');

移除商品

通过原始ID移除指定的商品。

boolean ShoppingCart::remove(string $rawId);

示例

ShoppingCart::remove('8a48aa7c8e5202841ddaf767bb4d10da');

销毁购物车

清理购物车。

boolean ShoppingCart::destroy();
boolean ShoppingCart::clean(); // alias of destroy();

示例

ShoppingCart::destroy();// or ShoppingCart::clean();

总价

返回所有商品的总价。

int | float ShoppingCart::total(); // alias of totalPrice();
int | float ShoppingCart::totalPrice();

示例

$total = ShoppingCart::total();
// or
$total = ShoppingCart::totalPrice();

行数计数

返回行数。

int ShoppingCart::countRows();

示例

ShoppingCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
ShoppingCart::add(37, 'Item name', 1, 100.00, ['color' => 'red', 'size' => 'M']);
ShoppingCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
ShoppingCart::add(127, 'foobar', 15, 100.00, ['color' => 'green', 'size' => 'S']);
$rows = ShoppingCart::countRows(); // 2

数量计数

返回所有商品的数量

int ShoppingCart::count($totalItems = true);

$totalItems : 当设置为 false 时,将返回行数。

示例

ShoppingCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
ShoppingCart::add(37, 'Item name', 1, 100.00, ['color' => 'red', 'size' => 'M']);
ShoppingCart::add(37, 'Item name', 5, 100.00, ['color' => 'red', 'size' => 'M']);
$count = ShoppingCart::count(); // 11 (5+1+5)

搜索商品

通过属性搜索商品。

Collection ShoppingCart::search(array $conditions);

示例

$items = ShoppingCart::search(['color' => 'red']);
$items = ShoppingCart::search(['name' => 'Item name']);
$items = ShoppingCart::search(['qty' => 10]);

检查是否为空

bool ShoppingCart::isEmpty();

指定关联模型

指定商品的关联模型。

Cart ShoppingCart::associate(string $modelName);

示例

ShoppingCart::associate('App\Models\Product');
$item = ShoppingCart::get('8a48aa7c8e5202841ddaf767bb4d10da');
$item->product->name; // $item->product is instanceof 'App\Models\Product'

集合与商品

CollectionOvertrue\LaravelShoppingCart\ItemIlluminate\Support\Collection 的实例,使用方法请参考:集合 - Laravel 文档。

Overtrue\LaravelShoppingCart\Item 的属性

  • id - 您的商品项目ID。
  • name - 商品名称。
  • qty - 商品数量。
  • price - 商品单价。
  • total - 商品总价。
  • __raw_id - 行的唯一ID。
  • __model - 与商品关联的模型名称。
  • ... 自定义属性。

以及方法

  • rawId() - 返回商品的原始ID。

事件

您可以轻松处理这些事件,例如

Event::on('shopping_cart.adding', function($attributes, $cart){
    // code
});

许可证

MIT