PHPackages                             hishamhadraoui/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. hishamhadraoui/cart

ActiveLibrary

hishamhadraoui/cart
===================

Your package description goes here

00PHP

Since May 14Pushed 5y agoCompare

[ Source](https://github.com/hishamhadraoui/Cart)[ Packagist](https://packagist.org/packages/hishamhadraoui/cart)[ RSS](/packages/hishamhadraoui-cart/feed)WikiDiscussions master Synced 2d ago

READMEChangelogDependenciesVersions (1)Used By (0)

Cart
====

[](#cart)

This is a very simple PHP cart library. Cart data can either be saved in PHP session or browser cookie.

Usage
-----

[](#usage)

### Configuration

[](#configuration)

> $cart= new Cart( \[**array** $options\] );

##### Options

[](#options)

ParameterTypeDescriptioncartMaxItem**int**The maximum item can be added to cart. 0 = UnlimiteditemMaxQuantity**int**The maximum quantity per item can be added to cart. 0 = UnlimiteduseCookie**bool**Use cookie to keep cart data when browser is closed.```
// Include core Cart library
require_once 'class.Cart.php';

// Initialize Cart object
$cart = new Cart([
  // Can add unlimited number of item to cart
  'cartMaxItem'      => 0,

  // Set maximum quantity allowed per item to 99
  'itemMaxQuantity'  => 99,

  // Do not use cookie, cart data will lost when browser is closed
  'useCookie'        => false,
]);
```

### Add Item

[](#add-item)

Adds an item to cart.

> **bool** $cart->add( **string** $id\[, **int** $quantity\]\[, **array** $attributes\] );

```
// Add item with ID #1001
$cart->add('1001');

// Add 5 item with ID #1002
$cart->add('1002', 5);

// Add item with ID #1003 with price, color, and size
$cart->add('1003', 1, [
  'price'  => '5.99',
  'color'  => 'White',
  'size'   => 'XS',
]);

// Item with same ID but different attributes will added as separate item in cart
$cart->add('1003', 1, [
  'price'  => '5.99',
  'color'  => 'Red',
  'size'   => 'M',
]);
```

### Update Item

[](#update-item)

Updates quantity of an item. Attributes **must be** provides if item with same ID exists with different attributes.

> **bool** $cart->update( **string** $id, **int** $quantity\[, **array** $attributes\] );

```
// Set quantity for item #1001 to 5
$cart->update('1001', 5);

// Set quantity for item #1003 to 2
$cart->update('1003', 2, [
  'price'  => '5.99',
  'color'  => 'Red',
  'size'   => 'M',
]);
```

### Remove Item

[](#remove-item)

Removes an item. Attributes **must be** provided to remove specified item, or all items with same ID will be removed from cart.

> **bool** $cart->remove( **string** $id\[, **array** $attributes\] );

```
// Remove item #1001
$cart->remove('1001');

// Remove item #1003 with color White and size XS
$cart->remove('1003', [
  'price'  => '5.99',
  'color'  => 'White',
  'size'   => 'XS',
]);
```

### Get Items

[](#get-items)

Gets a multi-dimensional array of items stored in cart.

> **array** $cart->getItems( );

```
// Get all items in the cart
$allItems = $cart->getItems();

foreach ($allItems as $items) {
  foreach ($items as $item) {
    echo 'ID: '.$item['id'].'';
    echo 'Qty: '.$item['quantity'].'';
    echo 'Price: '.$item['attributes']['price'].'';
    echo 'Size: '.$item['attributes']['size'].'';
    echo 'Color: '.$item['attributes']['color'].'';
  }
}
```

### Check Cart Empty

[](#check-cart-empty)

Checks if the cart is empty.

> **bool** $cart->isEmpty( );

```
if ($cart->isEmpty()) {
  echo 'There is nothing in the basket.';
}
```

### Get Total Item

[](#get-total-item)

Gets the total of items in the cart.

> **int** $cart->getTotaltem( );

```
echo 'There are '.$cart->getTotalItem().' items in the cart.';
```

### Get Total Quantity

[](#get-total-quantity)

Gets the total of quantity in the cart.

> **int** $cart->getTotalQuantity( );

```
echo $cart->getTotalQuantity();
```

### Get Attribute Total

[](#get-attribute-total)

Gets the sum of a specific attribute.

> **int** $cart->getAttributeTotal( **string** $attribute );

```
echo 'Total Price: $'.number_format($cart->getAttributeTotal('price'), 2, '.', ',').'';
```

### Clear Cart

[](#clear-cart)

Clears all items in the cart.

> $cart->clear( );

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

### Destroy Cart

[](#destroy-cart)

Destroys the entire cart session.

> $cart->destroy( );

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

### Item Exists

[](#item-exists)

Checks if an item exists in cart.

> **bool** $cart->isItemExists( **string** $id\[, **array** $attributes\] );

```
if ($cart->isItemExists('1001')) {
  echo 'This item already added to cart.';
}
```

###  Health Score

15

—

LowBetter than 3% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity0

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity29

Early-stage or recently created project

 Bus Factor1

Top contributor holds 78.3% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/0658ff18f01594078f99fc1fe4500fddbac02aa73bcae6fc45558c324df9001f?d=identicon)[hishamhadraoui](/maintainers/hishamhadraoui)

---

Top Contributors

[![seikan](https://avatars.githubusercontent.com/u/73107?v=4)](https://github.com/seikan "seikan (18 commits)")[![atanasov](https://avatars.githubusercontent.com/u/150792?v=4)](https://github.com/atanasov "atanasov (2 commits)")[![hishamhadraoui](https://avatars.githubusercontent.com/u/5504399?v=4)](https://github.com/hishamhadraoui "hishamhadraoui (1 commits)")[![josxha](https://avatars.githubusercontent.com/u/34318751?v=4)](https://github.com/josxha "josxha (1 commits)")[![tylunari](https://avatars.githubusercontent.com/u/2465627?v=4)](https://github.com/tylunari "tylunari (1 commits)")

### Embed Badge

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

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

PHPackages © 2026

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