PHPackages                             sevens/jsondb - 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. [Testing & Quality](/categories/testing)
4. /
5. sevens/jsondb

ActiveLibrary[Testing & Quality](/categories/testing)

sevens/jsondb
=============

Simple Php Test JSON Database; useful for development mode testing

v0.1.0(4y ago)045MITPHPPHP >=8.0.0

Since Sep 21Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/temmyscope/jsondb)[ Packagist](https://packagist.org/packages/sevens/jsondb)[ RSS](/packages/sevens-jsondb/feed)WikiDiscussions master Synced 3w ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

About Seven JsonDB
------------------

[](#about-seven-jsondb)

- Simple PHP JSON database for development/testing workflows.
- Seven JsonDB is developed by Elisha Temiloluwa a.k.a TemmyScope.
- Built on the Seven Vars utilities for arrays and strings.

### Requirements

[](#requirements)

- PHP 8.4+
- Composer

#### Installation

[](#installation)

```
composer require sevens/jsondb
```

### Usage: Seven\\JsonDB\\JsonDB HOW-TO

[](#usage-sevenjsondbjsondb-how-to)

***Completely unit tested***

- Valid Input Sample

```
$data = [
   'name' => 'Random 1',
   'age' => 24, 'password' => 'gHAST_V43SS',
   'nickname' => 'dick & harry'
];
```

- Initialization

```
use Seven\JsonDB\JsonDB;

$db = JsonDB::init($directory, $database);

$table = JsonDB::init($directory, $database, $tblName);

//OR

$table = $db->setTable($tblName);
```

- Make database

\*\*\* Use this syntax to create a database \*\*\*

```
use Seven\JsonDB\JsonDB;

$newDB = JsonDB::make(string $directory, string $database): bool;
#returns true if successfully created
```

- Create Table

\*\*\* use this syntax to create a table \*\*\*

```
$schema = [
	'name', 'email', 'password'
];
$table->createTable($table, $schema);

//To use the 'save' method, you need to use a schema when creating a table
```

***Note: id, createdAt and updatedAt are auto-generated fields but you can generate them as well***

- List all databases

\*\*\* Use this syntax to list all available databases \*\*\*

```
use Seven\JsonDB\JsonDB;

$newDB = JsonDB::list(string $directory): array;
#returns an array of databases found
```

- Count number of databases

\*\*\* Use this syntax to count number of available database \*\*\*

```
use Seven\JsonDB\JsonDB;

$newDB = JsonDB::count(string $directory): int;
#returns number of databases found
```

- Delete database

\*\*\* Use this syntax to delete a database \*\*\*

```
use Seven\JsonDB\JsonDB;

$newDB = JsonDB::delete($directory, $db): bool;
#returns true name if successfully deleted
```

- Empty a database; delete database content

\*\*\* Use this syntax to delete all contents from a database \*\*\*

```
use Seven\JsonDB\JsonDB;

$newDB = JsonDB::empty($directory, $db): bool;
#returns true on success
```

### Table Operations

[](#table-operations)

- Generate an Id

```
use Seven\JsonDB\Table;

$table->generateId(Table::TYPE_STRING || Table::TYPE_INT);

//default is Table::TYPE_STRING
```

- Get Last Insert Id

```
$table->lastInsertId();
```

- Save Data In the Table: Only works on tables that were created with schema

```
//$table->id = 1;
$table->name = 'Elisha Temiloluwa';
$table->email = 'Elisha@gmail.com';
$table->password = hash('SHA256', 'password');
$table->save();
```

- Insert Data In the Table

```
$table->insert([
	'email' => 'sammy@hotmail.com', 'name' => 'Sam Orji',
	'password' => hash('SHA256', 'passphr4s3'),
]);
```

- Find items in the table using certain conditions

```
$table->find([
	'email' => 'Elisha@gmail.com'
]);
```

- Find items in the table using id

```
$table->findById('38a92f92b1268c64');
```

- Find the first or last matching item

```
$table->first(['email' => 'Elisha@gmail.com']);
$table->last(['email' => 'Elisha@gmail.com']);
```

### Testing

[](#testing)

```
composer install
./vendor/bin/phpunit
```

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance49

Moderate activity, may be stable

Popularity8

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

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

Unknown

Total

1

Last Release

1746d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/16116067?v=4)[Elisha Temiloluwa](/maintainers/temmyscope)[@temmyscope](https://github.com/temmyscope)

---

Tags

jsontestdatabasedbengine

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/sevens-jsondb/health.svg)

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

###  Alternatives

[ubirak/rest-api-behat-extension

Rest Api Extension for Behat

41332.1k2](/packages/ubirak-rest-api-behat-extension)[fakerino/fakerino

Faker framework, for generate every kind of fake data for test, database seed, mock responses, other

12314.9k5](/packages/fakerino-fakerino)[sofa/eloquent-testsuite

Helpers for fast and reliable UNIT tests for your Eloquent Models with PHPUnit

10107.6k](/packages/sofa-eloquent-testsuite)[kielabokkie/jsonapi-behat-extension

Behat extension for testing JSON APIs

1516.6k](/packages/kielabokkie-jsonapi-behat-extension)

PHPackages © 2026

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