PHPackages                             slim-gee/dbcart-laravel - 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. [Database & ORM](/categories/database)
4. /
5. slim-gee/dbcart-laravel

ActiveLibrary[Database & ORM](/categories/database)

slim-gee/dbcart-laravel
=======================

Shopping cart

v1.1.0(6y ago)04MITPHPPHP ^7.2

Since Jan 2Pushed 5y agoCompare

[ Source](https://github.com/SlimGee/dbcart-laravel)[ Packagist](https://packagist.org/packages/slim-gee/dbcart-laravel)[ Docs](https://github.com/nabeel-alalmai/dbcart-laravel)[ RSS](/packages/slim-gee-dbcart-laravel/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (4)Versions (4)Used By (0)

DBCart
======

[](#dbcart)

Shopping Cart library for Laravel > 5.5 and Laravel 6 that uses database instead of sessions to store carts.

Features
--------

[](#features)

- Cart for guest users
- Cart for logged in users
- Guest Cart is merged with User Cart when logged in
- Singleton Cart instance to avoid unnecessary database queries. But also possible to avoid signleton cart if needed.
- Built on top of Eloquent Model, so easily extendable and all eloquent methods can be used.
- Multiple instances of cart
- Schedule expired carts for deletion

Before installation
-------------------

[](#before-installation)

if you already use [`dbcart by Hassansin`](https://github.com/hassansin/dbcart), please skip DB migrations and publishing configuration. This package is fully compatible.

Installation
------------

[](#installation)

1. Install the package via composer:

    ```
    composer require nabeelalalmai/dbcart-laravel
    ```

    The package will automatically register itself.
2. Publish database migrations(IF YOU USE dbcart:

    ```
    php artisan vendor:publish --provider="NabeelAlalmai\DBcart\CartServiceProvider" --tag="migrations"
    ```

    After the migration has been published you can create the `cart` and `cart_lines` tables by running the migrations:

    ```
    php artisan migrate
    ```

Configuration
-------------

[](#configuration)

Optionally, you can publish package config file:

```
php artisan vendor:publish --provider="NabeelAlalmai\DBcart\CartServiceProvider" --tag=config
```

Now, update `config/cart.php` if required

Usage
-----

[](#usage)

#### Get Cart Instance:

[](#get-cart-instance)

Get the current cart instance. It returns a singleton cart instance:

```
$cart = app('cart'); //using app() helper
```

or,

```
$cart = App::make('cart');
```

alternatively, you can avoid singleton instance and use the model class to load the cart instance from database everytime:

```
use NabeelAlalmai\DBcart\Models\Cart;
//...
$cart = Cart::current();
```

The idea of using singleton cart is that the cart object will be available globally throughout your app (e.g. controllers/models/views/view composers etc) for a single request. Also as you manipulate cart items, `$cart->item_count` and `$cart->total_price` would get updated.

#### Add an Item: `$cart->addItem($attributes)`

[](#add-an-item-cart-additemattributes)

```
$cart->addItem([
    'product_id' => 1,
    'unit_price' => 10.5,
    'quantity' => 1
]);
```

which is equivalent to `$cart->items()->create($attributes)`

#### Get Items: `$cart->items`

[](#get-items-cart-items)

Since `$cart` is eloquent model instance, you can use any of the eloquent methods to get items

```
$items = $cart->items // by dynamic property access
$items = $cart->items()->get()
$items = $cart->items()->where('quantity', '>=', 2)->get()
```

#### Update an Item: `$cart->updateItem($where, $attributes)`

[](#update-an-item-cart-updateitemwhere-attributes)

```
$cart->updateItem([
    'id' => 2
], [
    'product_id' => 1,
    'unit_price' => 10.5,
    'quantity' => 1
]);
```

which is equivalent to `$cart->items()->where($where)->first()->update($attributes)`

#### Remove an Item: `$cart->removeItem($where)`

[](#remove-an-item-cart-removeitemwhere)

```
$cart->removeItem([
    'id' => 2
]);
```

which is equivalent to `$cart->items()->where($where)->first()->delete()`

#### Clear Cart Items: `$cart->clear()`

[](#clear-cart-items-cart-clear)

Remove all items from the cart

```
$cart->clear();
```

#### Checkout cart: `$cart->checkout()`

[](#checkout-cart-cart-checkout)

This method only updates `status` and `placed_at` column values. `status` is set to `pending`

```
$cart->checkout();
```

#### Move item(s) between carts:

[](#move-items-between-carts)

To move all items from one cart to another cart instance:

```
$cart = app('cart');
$wishlist = app('cart', ['name' => 'wishlist']);

//move all wishlist items to cart
$wishlist->moveItemsTo($cart);
```

To move a single item between carts:

```
$cart = app('cart');
$wishlist = app('cart', ['name' => 'wishlist']);

//move an wishlist item to cart
$item = $wishlist->items()->where(['product_id' => 1])->first();
$item->moveTo($cart);
```

#### Get Cart Attributes

[](#get-cart-attributes)

```
$total_price = $cart->total_price; // cart total price
$item_count = $cart->item_count; // cart items count
$date_placed = $cart->placed_at; // returns Carbon instance
```

#### Cart Statuses

[](#cart-statuses)

Supports several cart statuses:

- `active`: currently adding items to the cart
- `expired`: cart is expired, meaningful for session carts
- `pending`: checked out carts
- `completed`: completed carts

```
use NabeelAlalmai\DBcart\Models\Cart;

// get carts based on their status: active/expired/pending/complete
$active_carts = Cart::active()->get();
$expired_carts = Cart::expired()->get();
$pending_carts = Cart::pending()->get();
$completed_carts = Cart::completed()->get();
```

#### Working with Multiple Cart Instances

[](#working-with-multiple-cart-instances)

By default, cart instances are named as `default`. You can load other instances by providing a name:

```
$cart = app('cart'); // default cart, same as: app('cart', [ 'name' => 'default'];
$sales_cart = app('cart', [ 'name' => 'sales']);
$wishlist = app('cart', [ 'name' => 'wishlist']);
```

or, without singleton carts:

```
use NabeelAlalmai\DBcart\Models\Cart;
//...
$cart = Cart::current();
$sales_cart =  Cart::current('sales');
$wishlist =  Cart::current('wishlist');
```

To get carts other than `default`:

```
$pending_sales_carts = Cart::instance('sales')->pending()->get();
```

#### Delete Expired Carts:

[](#delete-expired-carts)

The guest carts depend on the session lifetime. They are valid as long as the session is not expired. You can increase session lifetime in `config/session.php` to increase cart lifetime. When a session expires, a new cart instance will be created in database and the old one will no longer be used. Over time, these expired carts could pile-up in database.

Laravel Task Scheduler comes to the rescue. To enable scheduler just add following to the crontab in your server:

```
* * * * * php /path/to/artisan schedule:run >> /dev/null 2>&1

```

That's it. The module will now check for expired carts in every hour and delete them. This won't affect the carts for loggedin users.

#### Other features:

[](#other-features)

Get Cart User: `$cart->user`

Get Item Product: `$item->product`

Is Cart Empty: `$cart->isEmpty()`

If an item exists in cart: `$cart->hasItem(['id' => 10])`

Expire the cart: `cart->expire();`

Set to `completed` status: `$cart->complete();`

Extending Cart Model
--------------------

[](#extending-cart-model)

It's easy to extend DBCart. You can extend base DBCart model and add your own methods or columns. Follow these steps to extend the cart model:

1. Create a model by extending `NabeelAlalmai\DBcart\Models\Cart`:

    ```
    namespace App;

    use NabeelAlalmai\DBcart\Models\Cart as BaseCart;

    class Cart extends BaseCart
    {
        //override or add your methods here ...

        public function getSubTotalAttribute(){
            return $this->attributes['total_price'];
        }
        public function getGrandTotalAttribute(){
            //taking discount, tax etc. into account
            return $this->sub_total - $this->discount;
        }

    }
    ```
2. Update `cart_model` in `config/cart.php` with the fully qualified class name of the extended model.

    ```
    'cart_model' => App\Cart::class,
    ```
3. That's it, you can now load the cart as usual:

    ```
    $cart = App::make('cart');
    ```

You can also follow the above steps and create your own `CartLine` model by extending `NabeelAlalmai\DBcart\Models\CartLine`. Be sure to update `config/cart.php` to reflect your changes.

Disclaimer
----------

[](#disclaimer)

I was using [`dbcart by Hassansin`](https://github.com/hassansin/dbcart) but it doesn't support Laravel 6. So, I re-wrote the package to support Laravel > 5.5. If you use dbcart by Hassansin you can use this package and it should work with no conflicts.

Support
-------

[](#support)

Reach out to me at one of the following places!

- Twitter at [`Nabeel Al Almai - نبيل الالمعي`](http://twitter.com/nabeel_alalmai)

---

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity3

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

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 ~0 days

Total

3

Last Release

2321d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/858adba2e9ad707913de77ce85bec37ee60a1acbf0a2877ad8ff1c486f5c8335?d=identicon)[flixtechs-labs](/maintainers/flixtechs-labs)

---

Top Contributors

[![SlimGee](https://avatars.githubusercontent.com/u/42301835?v=4)](https://github.com/SlimGee "SlimGee (6 commits)")[![alalm3i](https://avatars.githubusercontent.com/u/6444894?v=4)](https://github.com/alalm3i "alalm3i (3 commits)")

---

Tags

laraveldatabasee-commerceshopping cartNabeel Al-Almaidbcart-laravel

### Embed Badge

![Health badge](/badges/slim-gee-dbcart-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/slim-gee-dbcart-laravel/health.svg)](https://phpackages.com/packages/slim-gee-dbcart-laravel)
```

###  Alternatives

[illuminate/database

The Illuminate Database package.

2.8k52.4M9.4k](/packages/illuminate-database)[mongodb/laravel-mongodb

A MongoDB based Eloquent model and Query builder for Laravel

7.1k7.2M71](/packages/mongodb-laravel-mongodb)[spiritix/lada-cache

A Redis based, automated and scalable database caching layer for Laravel

591444.8k2](/packages/spiritix-lada-cache)[pdphilip/elasticsearch

An Elasticsearch implementation of Laravel's Eloquent ORM

145360.2k4](/packages/pdphilip-elasticsearch)[cybercog/laravel-clickhouse

ClickHouse migrations for Laravel

163166.8k](/packages/cybercog-laravel-clickhouse)[illuminatech/config

Provides support for Laravel application runtime configuration managed in persistent storage

14921.0k1](/packages/illuminatech-config)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)