PHPackages aiarmada/cart - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Framework](/categories/framework) 4. / 5. aiarmada/cart ActiveLibrary[Framework](/categories/framework) aiarmada/cart ============= A comprehensive commerce ecosystem for Laravel with cart, payments, vouchers, shipping, and inventory management. v1.4.7(5mo ago)0964MITPHPPHP ^8.4 Since Nov 6Pushed 1mo agoCompare [ Source](https://github.com/AIArmada/cart)[ Packagist](https://packagist.org/packages/aiarmada/cart)[ Docs](https://github.com/aiarmada/commerce)[ RSS](/packages/aiarmada-cart/feed)WikiDiscussions main Synced 1mo ago READMEChangelogDependencies (2)Versions (34)Used By (4) AIArmada Cart ============= [](#aiarmada-cart) A modern, production-grade shopping cart engine for Laravel 12 applications. Features -------- [](#features) - **Multiple Storage Drivers** – Session, cache, and database storage with seamless switching - **Multi-Instance Carts** – Support multiple cart buckets per user (cart, wishlist, compare) - **Precision Calculations** – Money objects via `akaunting/money` for accurate financial math - **Flexible Conditions** – Discounts, taxes, fees, and shipping with targeted application - **Payment Gateway Ready** – Implements `CheckoutableInterface` for any payment provider - **Concurrency Safe** – Optimistic locking prevents race conditions - **Event-Driven** – Hooks for logging, analytics, and business logic Requirements ------------ [](#requirements) - PHP 8.4+ - Laravel 12.x Installation ------------ [](#installation) ``` composer require aiarmada/cart ``` Laravel auto-discovers the service provider. To publish configuration: ``` php artisan vendor:publish --tag=cart-config ``` For database storage, publish and run migrations: ``` php artisan vendor:publish --tag=cart-migrations php artisan migrate ``` Quick Start ----------- [](#quick-start) ``` use AIArmada\Cart\Facades\Cart; // Add items Cart::add('laptop-001', 'MacBook Pro 16"', 2499.00, 1, [ 'sku' => 'MBP16-2024', 'color' => 'Space Gray', ]); // Get totals echo Cart::count(); // Total quantity echo Cart::total()->format(); // "$2,499.00" // Apply conditions Cart::addDiscount('promo', '10%'); Cart::addTax('vat', '8%'); Cart::addShipping('standard', '15.00'); // Work with items $item = Cart::get('laptop-001'); Cart::update('laptop-001', ['quantity' => 2]); Cart::remove('laptop-001'); // Multiple instances Cart::instance('wishlist')->add('monitor-001', 'Display', 599.00); ``` Storage Drivers --------------- [](#storage-drivers) DriverBest ForPersistence`session`Simple apps, developmentSession lifetime`cache`High traffic, API backendsTTL-based`database`E-commerce, multi-devicePermanent``` // config/cart.php 'storage' => env('CART_STORAGE', 'database'), ``` Conditions ---------- [](#conditions) Apply discounts, taxes, and fees at different calculation phases: ``` use AIArmada\Cart\Conditions\CartCondition; use AIArmada\Cart\Conditions\TargetPresets; // Percentage discount Cart::addDiscount('summer-sale', '20%'); // Fixed amount Cart::addDiscount('welcome', '-10.00'); // Custom condition $condition = new CartCondition( name: 'vip-discount', type: 'discount', target: TargetPresets::cartSubtotal(), value: '-15%', rules: [fn($cart) => auth()->user()?->isVip()], ); Cart::addCondition($condition); ``` Payment Integration ------------------- [](#payment-integration) Cart implements `CheckoutableInterface` for seamless payment gateway integration: ``` use AIArmada\Chip\Gateways\ChipGateway; $gateway = app(ChipGateway::class); $cart = app(\AIArmada\Cart\Cart::class); $payment = $gateway->createPayment($cart, $customer, [ 'success_url' => route('checkout.success'), 'failure_url' => route('checkout.failed'), ]); return redirect($payment->getCheckoutUrl()); ``` Guest to User Migration ----------------------- [](#guest-to-user-migration) Automatically migrate guest carts when users log in: ``` // config/cart.php 'migration' => [ 'auto_migrate_on_login' => true, 'merge_strategy' => 'add_quantities', // or keep_highest_quantity, keep_user_cart ], ``` Events ------ [](#events) Listen to cart lifecycle events: - `CartCreated`, `CartCleared`, `CartDestroyed`, `CartMerged` - `ItemAdded`, `ItemUpdated`, `ItemRemoved` - `CartConditionAdded`, `CartConditionRemoved` - `ItemConditionAdded`, `ItemConditionRemoved` - `MetadataAdded`, `MetadataRemoved`, `MetadataBatchAdded`, `MetadataCleared` ``` use AIArmada\Cart\Events\ItemAdded; Event::listen(ItemAdded::class, function ($event) { Log::info('Item added', ['item' => $event->cartItem->id]); }); ``` JSON Column Type ---------------- [](#json-column-type) Migrations default to `json` columns. For PostgreSQL with `jsonb`: ``` COMMERCE_JSON_COLUMN_TYPE=jsonb # or per-package CART_JSON_COLUMN_TYPE=jsonb ``` Documentation ------------- [](#documentation) Full documentation is available in the [`docs/`](docs/index.md) directory: - [Getting Started](docs/getting-started.md) - [Cart Operations](docs/cart-operations.md) - [Conditions & Pricing](docs/conditions.md) - [Storage Drivers](docs/storage.md) - [Payment Integration](docs/payment-integration.md) - [Configuration](docs/configuration.md) Development ----------- [](#development) ``` composer install vendor/bin/pest vendor/bin/pint --dirty ``` Testing ------- [](#testing) ``` vendor/bin/pest tests/src/Cart --parallel ``` License ------- [](#license) MIT License. See [LICENSE](../../LICENSE). ### Health Score 44 — FairBetter than 92% of packages Maintenance82 Actively maintained with recent releases Popularity9 Limited adoption so far Community8 Small or concentrated contributor base Maturity64 Established project with proven stability How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~4 days Recently: every ~30 days Total 33 Last Release 53d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/726da4efcb731bc0ebcdd0b7ce64759e1f8dd63f6f771eab335458f6a2f2d3af?d=identicon)[sairiz](/maintainers/sairiz) ### Embed Badge ![Health badge](/badges/aiarmada-cart/health.svg) ``` [![Health](https://phpackages.com/badges/aiarmada-cart/health.svg)](https://phpackages.com/packages/aiarmada-cart) ``` ### Alternatives [laravel/telescope An elegant debug assistant for the Laravel framework. 5.2k67.8M190](/packages/laravel-telescope)[spiral/roadrunner RoadRunner: High-performance PHP application server and process manager written in Go and powered with plugins 8.4k12.2M84](/packages/spiral-roadrunner)[nolimits4web/swiper Most modern mobile touch slider and framework with hardware accelerated transitions 41.8k177.2k1](/packages/nolimits4web-swiper)[laravel/dusk Laravel Dusk provides simple end-to-end testing and browser automation. 1.9k36.7M256](/packages/laravel-dusk)[laravel/prompts Add beautiful and user-friendly forms to your command-line applications. 708181.8M591](/packages/laravel-prompts)[cakephp/chronos A simple API extension for DateTime. 1.4k47.7M121](/packages/cakephp-chronos) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)