thanhphuc1230/simple-cart-php

A simple shopping cart package for Laravel

dev-main 2025-05-19 01:25 UTC

Requires

• php: ^7.4|^8.0
• illuminate/events: ^8.0|^9.0
• illuminate/session: ^8.0|^9.0
• illuminate/support: ^8.0|^9.0

Requires (Dev)

• orchestra/testbench: ^6.0|^7.0
• phpunit/phpunit: ^9.0

MIT

• Thanh Phuc

README

A simple shopping cart package for Laravel.

Installation

composer require thanhphuc1230/simple-cart-php

Configuration

Publish the configuration file:

php artisan vendor:publish --provider="Thanhphuc1230\ShoppingCart\ShoppingCartServiceProvider" --tag="config"

In the config/cart.php file, you can configure the tax rate:

return [
    'tax_rate' => 10, // 10% tax rate
    // ... other configs
];

Usage

Adding Items to Cart

// Basic item
Cart::add('product_id', 'Product Name', 1, 9.99);

// With options
Cart::add('product_id', 'Product Name', 1, 9.99, [
    'size' => 'L',
    'color' => 'red'
]);

// With options and custom attributes
Cart::add('product_id', 'Product Name', 1, 9.99, 
    ['size' => 'L', 'color' => 'red'], // options
    [
        'sku' => 'SP001',
        'brand' => 'Nike',
        'category' => 'Shoes',
        'description' => 'Product description',
        'image' => 'product1.jpg',
        'weight' => 500,
        'discount' => 10
    ] // attributes
);

Updating Items

// Update quantity
Cart::update('product_id', 2);

// Update quantity and attributes
Cart::update('product_id', 2, [
    'discount' => 20,
    'note' => 'Updated discount'
]);

Removing Items

Cart::remove('product_id');

Getting Item Information

$item = Cart::get('product_id');
echo $item['name']; // Product Name
echo $item['sku']; // SP001
echo $item['brand']; // Nike
echo $item['discount']; // 20

Getting All Items

$items = Cart::content();
foreach($items as $item) {
    echo $item['name'];
    echo $item['sku'];
    echo $item['brand'];
}

Counting Items

Cart::count();

Calculating Totals

// Subtotal (before tax)
$subtotal = Cart::total();

// Tax amount
$tax = Cart::tax();

// Total with tax
$total = Cart::totalWithTax();

Clearing Cart

Cart::clear();