yasinsvr / cart

v1.1.0 2025-06-05 16:04 UTC

Requires

• php: ^8.1
• illuminate/support: ^10.0 || ^11.0 || ^12.0
• illuminate/translation: ^10.0 || ^11.0 || ^12.0
• illuminate/validation: ^10.0 || ^11.0 || ^12.0

Requires (Dev)

• imanghafoori/eloquent-mockery: dev-main
• mockery/mockery: ^1.4.2
• phpunit/phpunit: ^10.0
• symfony/var-dumper: ^5.1

MIT

• Yasin Zolfaghari

• cart
• laravel
• shopping cart

Published on Packagist.org on 2025-06-27 14:09 UTC

README

🛒 Laravel Shopping Cart

A simple and reusable shopping cart package for Laravel applications.

📖 About

Laravel Shopping Cart is a lightweight shopping cart package designed for Laravel applications.

The package provides a simple API for managing cart items without requiring a large amount of application-level code.

It can be installed through Composer and integrated into a Laravel application as a reusable package.

✨ Features

• 🛒 Add items to the cart
• 🔄 Update cart items
• 🗑️ Remove items
• 📦 Retrieve cart contents
• 💰 Calculate cart totals
• 🧩 Item attributes and options
• ⚡ Simple and reusable API
• 🔌 Laravel service provider integration
• 🎯 Facade support
• 🧪 PHPUnit test structure
• ⚙️ Publishable package configuration

📦 Requirements

• PHP ^8.1
• Laravel 10.x, 11.x or 12.x

🚀 Installation

Install the package using Composer:

composer require yasinsvr/cart

After installation, Laravel will automatically discover the package.

⚙️ Configuration

If you want to publish the package configuration:

php artisan vendor:publish \
    --provider="YasinSVR\Cart\CartServiceProvider" \
    --tag="config"

This allows you to customize the package configuration for your application.

🛠️ Basic Usage

Add an Item

use YasinSVR\Cart\Facades\Cart;

Cart::add(
    id: 1,
    name: 'Product',
    quantity: 2,
    price: 150000
);

Get Cart Contents

$items = Cart::content();

Update an Item

Cart::update($rowId, [
    'quantity' => 3,
]);

Remove an Item

Cart::remove($rowId);

Get Cart Total

$total = Cart::total();

The exact method signatures may vary depending on the installed package version. See the source code and tests for the complete API.

🧱 Architecture

The package follows a modular package-oriented structure.

src/
├── Cart.php
├── CartServiceProvider.php
├── Facades/
├── Contracts/
├── Models/
└── ...

The package separates cart functionality from the Laravel application itself, making the cart logic reusable across different projects.

🧪 Testing

The project includes a PHPUnit test suite.

Run the tests with:

composer test

Or, if PHPUnit is configured directly:

vendor/bin/phpunit

🔄 Supported Laravel Versions

Laravel	PHP
10.x	^8.1
11.x	^8.1
12.x	^8.1

📚 Package

The package is available through Packagist:

yasinsvr/cart

composer require yasinsvr/cart

🗺️ Roadmap

Planned improvements may include:

• More complete API documentation
• More usage examples
• Improved test coverage
• Additional cart operations
• Better documentation for advanced use cases

🤝 Contributing

Contributions, suggestions and bug reports are welcome.

If you find a bug or have an idea for improving the package, feel free to open an issue or submit a pull request.

📄 License

This package is open-sourced software licensed under the MIT License.

Made with ❤️ by Yasin Zolfaghari