PHPackages                             jord-jd/exiguous-ecommerce - 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. jord-jd/exiguous-ecommerce

ActiveLibrary

jord-jd/exiguous-ecommerce
==========================

Exiguous Ecommerce is a super simple ecommerce library, that uses flat files and takes a very minimalistic approach.

v3.0.0(3mo ago)72[1 issues](https://github.com/Jord-JD/exiguous-ecommerce/issues)LGPL-3.0-onlyPHPPHP >=5.3.0

Since Oct 27Pushed 3mo ago2 watchersCompare

[ Source](https://github.com/Jord-JD/exiguous-ecommerce)[ Packagist](https://packagist.org/packages/jord-jd/exiguous-ecommerce)[ GitHub Sponsors](https://github.com/DivineOmega)[ RSS](/packages/jord-jd-exiguous-ecommerce/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (6)DependenciesVersions (7)Used By (0)

🛒 Exiguous Ecommerce
====================

[](#-exiguous-ecommerce)

Exiguous Ecommerce is a super simple ecommerce library, that uses flat files and takes a very minimalistic approach.

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

[](#installation)

Just run the following Composer command to download/install Exiguous Ecommerce and create relevant autoload files.

```
composer require jord-jd/exiguous-ecommerce

```

If your framework does not already do so, you must add `require_once "vendor/autoload.php"` to any files in which you wish to use Exiguous Ecommerce.

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

[](#configuration)

Exiguous Ecommerce stores all of its data within a `data` directory. An example `data` directory is provided in this package.

Before use, you should then copy the `data` directory to another location and then specify this location your project's environment. If you are using Laravel, this can be done by setting an `EXIGUOUS_ECOMMERCE_DATA_DIRECTORY` variable in your `.env` file, as follows.

```
EXIGUOUS_ECOMMERCE_DATA_DIRECTORY=/var/www/ecommerce-site/path-to-data-directory/

```

If you are not using a framework that supports this, you can use the standard PHP function `putenv` to set this environment variable. Alternatively, you could use [dotenv-loader](https://github.com/Jord-JD/dotenv-loader) to add `.env` file support to your project.

Please note that it is important the `EXIGUOUS_ECOMMERCE_DATA_DIRECTORY` variable is set with a trailing slash present.

For security reasons, you should place the `data` directory in a location which is not web-accessible. In case the data directory is placed in a web accessible location by accident, a `.htaccess` file is provided that should deny web users access to the directory's content in most common web server configurations.

Quick Start Examples
--------------------

[](#quick-start-examples)

Getting products and categories:

```
$category = \JordJD\ExiguousEcommerce\Category::findBySlug("fluffy-things");
$products = $category->products();

foreach($products as $product) {
    echo $product->data->name;
}
```

```
$product = \JordJD\ExiguousEcommerce\Product::findBySlug("teddy-bear");
$categories = $product->categories();

$mainCategoryName = $categories[0]->data->name;
```

Getting the current user's basket and adding a product to it:

```
$product = \JordJD\ExiguousEcommerce\Product::findBySlug("teddy-bear");

$basket = \JordJD\ExiguousEcommerce\Basket::findCurrent();

$basket->addProduct($product); // Add one Teddy Bear

$basket->addProduct($product, 2); // Add another two Teddy Bears!

var_dump($basket->items); // Outputs an array of, you guessed it, basket items! ^_^

// ^ This would show 1 basket item with a quantity of 3 teddy bears.
```

Removing a product from a basket:

```
$product = \JordJD\ExiguousEcommerce\Product::findBySlug("teddy-bear");

$basket = \JordJD\ExiguousEcommerce\Basket::findCurrent();

$basket->removeProduct($product); // Removes all teddy bears from the basket
```

Setting/Offsetting the quantity of a product in the basket:

```
$product = \JordJD\ExiguousEcommerce\Product::findBySlug("teddy-bear");

$basket = \JordJD\ExiguousEcommerce\Basket::findCurrent();

$basket->addProduct($product); // Add one Teddy Bear

$basket->setProductQuantity($product, 10); // Set the number of Teddy Bears in the basket to ten

$basket->offsetProductQuantity($product, 10); // Add ten more Teddy Bears

$basket->offsetProductQuantity($product, -5); // Remove five of those Teddy Bears
```

Migrating the basket to an order:

```
$basket = \JordJD\ExiguousEcommerce\Basket::findCurrent();

$basket->convertToOrder();
```

Getting and using settings:

```
// Retrieves settings from the core.json file within the .settings directory
$coreSettings = \JordJD\ExiguousEcommerce\Settings::find('core');

echo $coreSettings->data->primaryCurrency; // Output the ecommerce's primary currency setting
```

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance80

Actively maintained with recent releases

Popularity7

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity62

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~679 days

Recently: every ~831 days

Total

6

Last Release

93d ago

Major Versions

v1.1.2 → v2.0.02026-02-14

v2.0.0 → v3.0.02026-02-14

### Community

Maintainers

![](https://www.gravatar.com/avatar/c580cdf7c14898fff179cdfc1085892091d5d2f49d917873a12365af9ac77c93?d=identicon)[Jord-JD](/maintainers/Jord-JD)

---

Top Contributors

[![Jord-JD](https://avatars.githubusercontent.com/u/650645?v=4)](https://github.com/Jord-JD "Jord-JD (63 commits)")

---

Tags

basketcartecommerceflat-filephp-librarylibraryecommercePHP Libraryecommerce libraryPHP ecommerce library

### Embed Badge

![Health badge](/badges/jord-jd-exiguous-ecommerce/health.svg)

```
[![Health](https://phpackages.com/badges/jord-jd-exiguous-ecommerce/health.svg)](https://phpackages.com/packages/jord-jd-exiguous-ecommerce)
```

###  Alternatives

[inhere/php-validate

generic data validate, filter library of the php

26787.4k13](/packages/inhere-php-validate)[niiknow/bayes

a machine learning lib

6950.0k](/packages/niiknow-bayes)[rapidwebltd/php-uk-bank-holidays

This library enables developers to easily retrieve UK Bank Holiday details. Holidays can be retrieved for England & Wales, Scotland, and Northern Ireland. Information about these holidays can optionally be restricted by month or date.

12405.5k](/packages/rapidwebltd-php-uk-bank-holidays)[soosyze/queryflatfile

The Queryflatfile is PHP library for simple database not SQL

181.0k1](/packages/soosyze-queryflatfile)

PHPackages © 2026

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