PHPackages                             osaris-uk/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. [Database & ORM](/categories/database)
4. /
5. osaris-uk/cart

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

osaris-uk/cart
==============

Shopping Cart library for Laravel 6 that uses Database instead of Sessions

2.4.1(4mo ago)072[3 PRs](https://github.com/osaris-uk/cart/pulls)MITPHPPHP ^7.2 | ^8.0

Since Dec 5Pushed 4mo agoCompare

[ Source](https://github.com/osaris-uk/cart)[ Packagist](https://packagist.org/packages/osaris-uk/cart)[ Docs](https://github.com/osaris-uk/cart)[ RSS](/packages/osaris-uk-cart/feed)WikiDiscussions master Synced today

READMEChangelog (9)Dependencies (4)Versions (14)Used By (0)

[![Build Status](https://camo.githubusercontent.com/ded00ffdc1ecda59292ded2eed390b0483ff3ddecb674f54da94807518bb05ad/68747470733a2f2f7472617669732d63692e636f6d2f6f73617269732d756b2f636172742e7376673f6272616e63683d6d6173746572)](https://travis-ci.com/osaris-uk/cart)

Cart
====

[](#cart)

Shopping Cart library for 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

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

[](#installation)

1. Install with composer command:

    ```
        composer require osaris-uk/cart
    ```
2. Next, add a new provider to the providers array in config/app.php:

    ```
    'providers' => [
        //...
        OsarisUk\Cart\CartServiceProvider::class,
        //...
    ],
    ```
3. Then, publish database migrations and run migration:

    ```
    php artisan vendor:publish --provider="OsarisUk\Cart\CartServiceProvider" --tag=migrations
    php artisan migrate
    ```

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

[](#configuration)

Optionally, you can publish package config file:

```
php artisan vendor:publish --provider="OsarisUk\Cart\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 OsarisUk\Cart\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();
```

#### Refresh Cart Totals: `$cart->refreshCartTotals()`

[](#refresh-cart-totals-cart-refreshcarttotals)

Refresh the cart based on all items in the cart

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

#### 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 OsarisUk\Cart\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 OsarisUk\Cart\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 Cart. You can extend base Cart model and add your own methods or columns. Follow these steps to extend the cart model:

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

    ```
    namespace App;

    use OsarisUk\Cart\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 `OsarisUk\Cart\Models\CartLine`. Be sure to update `config/cart.php` to reflect your changes.

Credits
-------

[](#credits)

This package is a modified version of [hassansin/dbcart](https://github.com/hassansin/dbcart). The license for this package remains unchanged from the original.

###  Health Score

44

—

FairBetter than 92% of packages

Maintenance76

Regular maintenance activity

Popularity9

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor1

Top contributor holds 94.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 ~277 days

Recently: every ~261 days

Total

9

Last Release

130d ago

Major Versions

1.0 → 2.02020-05-03

PHP version history (2 changes)1.0PHP >=7.2.0

2.4PHP ^7.2 | ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/c655f8ff1687b3f3a9156d917431f14c05dbc187e19e11201348c894afb35045?d=identicon)[osaris-uk](/maintainers/osaris-uk)

---

Top Contributors

[![john-dent](https://avatars.githubusercontent.com/u/24832003?v=4)](https://github.com/john-dent "john-dent (18 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")

---

Tags

laraveldatabaseecommercecartshopping cartlaravel6

### Embed Badge

![Health badge](/badges/osaris-uk-cart/health.svg)

```
[![Health](https://phpackages.com/badges/osaris-uk-cart/health.svg)](https://phpackages.com/packages/osaris-uk-cart)
```

###  Alternatives

[illuminate/database

The Illuminate Database package.

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

ClickHouse migrations for Laravel

163166.8k](/packages/cybercog-laravel-clickhouse)[amsgames/laravel-shop

Package set to provide shop or e-commerce functionality (such as CART, ORDERS, TRANSACTIONS and ITEMS) to Laravel for customizable builds.

4845.9k](/packages/amsgames-laravel-shop)[illuminatech/config

Provides support for Laravel application runtime configuration managed in persistent storage

14921.0k1](/packages/illuminatech-config)[toponepercent/baum

Baum is an implementation of the Nested Set pattern for Eloquent models.

3154.7k](/packages/toponepercent-baum)[vectorial1024/laravel-cache-evict

Efficiently remove expired Laravel file/database cache data

5813.2k](/packages/vectorial1024-laravel-cache-evict)

PHPackages © 2026

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