PHPackages                             r0mdau/jisly - 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. r0mdau/jisly

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

r0mdau/jisly
============

The smallest NoSQL database library, flat file JSON.

2.2.0(2y ago)26624[1 issues](https://github.com/r0mdau/jisly/issues)Apache-2.0PHPPHP >=8.2CI passing

Since Nov 12Pushed 1mo ago4 watchersCompare

[ Source](https://github.com/r0mdau/jisly)[ Packagist](https://packagist.org/packages/r0mdau/jisly)[ Docs](https://github.com/r0mdau/jisly)[ RSS](/packages/r0mdau-jisly/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (6)Versions (8)Used By (0)

Jisly
=====

[](#jisly)

[![PHPUnit](https://github.com/r0mdau/jisly/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/r0mdau/jisly/actions/workflows/unit-tests.yml/badge.svg)[![Coverage Status](https://camo.githubusercontent.com/bd4a557b09cb0dcda3f56f5d6fa9f2849094409faf7b3e0821d7719d919da233/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f72306d6461752f6a69736c792f62616467652e7376673f6272616e63683d6d61696e)](https://coveralls.io/github/r0mdau/jisly?branch=main)[![Known Vulnerabilities](https://camo.githubusercontent.com/1e95e6c913c54aa57449cd1f13a23d853f43d050f3f8f552b2d88d97f333ab82/68747470733a2f2f736e796b2e696f2f746573742f6769746875622f72306d6461752f6a69736c792f62616467652e737667)](https://snyk.io/test/github/r0mdau/jisly)

The smallest PHP lightweight NoSQL database library, flat file JSON.

The main goal of Jisly is to allow you to quickly start your project with the possibility of memory and flat-file storage using a NoSQL (document oriented) query syntax.

[Version française ici](https://github.com/r0mdau/jisly/blob/main/README.fr.md)

**Concurrent access is managed !**

How to install and load
=======================

[](#how-to-install-and-load)

This lib can be found on [Packagist](https://packagist.org/packages/r0mdau/jisly)

```
composer require r0mdau/jisly:^2.0

```

Loading the library
-------------------

[](#loading-the-library)

Jisly relies on the [PSR-4 specification](https://www.php-fig.org/psr/psr-4/) for autoloading classes from file paths.

```
use Jisly\JislyCollection;

public function saveCart(): void {
    $jisly = new JislyCollection("/tmp/data", "cart");
    ...
}

```

Definitions
===========

[](#definitions)

1. Each document has a unique identifier called `_rid`.
2. Each collection is physically represented by a file.
3. The files are stored in a single working directory. The Jisly class is instantiated with the path to this directory as a parameter.
4. Each time you CRUD something, all datas are stored in memory.
5. And datas are saved on filesystem.

Examples of use
===============

[](#examples-of-use)

Initialization of the class
---------------------------

[](#initialization-of-the-class)

`$directory` contains the path to the directory where the files (=collections) of the data model will be stored.

```
$database = new Jisly($directory);
```

To access a collection
----------------------

[](#to-access-a-collection)

`$name` contains the name of the collection we want to request. Example : `user`.

Returns an object **JislyCollection** :

```
$database->collection($name);
```

Warning : each first time you access a collection, all datas are stored in memory.

To call a collection
--------------------

[](#to-call-a-collection)

**PREAMBLE :**The Insert, Update, Delete methods return a boolean, `true` if the action went well, `false` otherwise.

### Insert method

[](#insert-method)

Insert the array into the specified collection in JSON format and assigns a unique `_rid` identifier to the document if it has not been specified :

```
$successBool = $database->collection($file)->insert(
  [
    "name" => "Lucas",
    "firstname" => "Georges"
  ]
);
```

### Delete method

[](#delete-method)

*You must first find all documents to delete to provide the `_rid` attribute to the delete method.*

Remove the only document in the collection which has the value `$rid` to the attribute `_rid` :

```
$successBool = $database->collection($file)->delete($rid);
```

### Select method

[](#select-method)

Returns all documents in the collection in an **array()** of objects :

```
$results = $database->collection($file)->find();
```

Return all documents in the collection that have a `name` attribute with `Lucas` as value in an **array()** of objects :

```
$results = $database->collection($file)->find(
  [
    "name" => "Lucas"
  ]
);
```

Return the first document that as a `name` attribute with `19` as an object value :

```
$result = $database->collection($file)->findOne(
  [
    "name" => 19
  ]
);
```

#### Logical operators OR and AND

[](#logical-operators-or-and-and)

These two logical operators can be used on `find` and `findOne` methods.

If no logical operator is provided, **OR** is used.

Return all documents in the collection that have a `name` attribute with `Lucas` **OR** a `firstname` attribute with `Georges` as values in an **array()** of objects :

```
$result = $database->collection($file)->find(
  [
    "firstname" => "Georges",
    "name" => "Lucas"
  ], JislyCollection::LOGICAL_OR
);
```

Return the first document in the collection that have a `name` attribute with `Lucas` **AND** a `firstname` attribute with `Georges` as an object value :

```
$result = $database->collection($file)->findOne(
  [
    "firstname" => "Georges",
    "name" => "Lucas"
  ], JislyCollection::LOGICAL_AND
);
```

### Update method

[](#update-method)

For the modification, the documents concerned are entirely replaced by the second **array()** given in parameter.

*You must first find all the documents to replace to provide the `_rid` attribute to the update method.*

Modify the only document in the collection whose value $rid to the `_rid` attribute :

```
$successBool = $database->collection($file)->update(
  $rid,
  [
    "firstname" => "Georges",
    "name" => "Lucas"
  ]
);
```

###  Health Score

48

—

FairBetter than 94% of packages

Maintenance62

Regular maintenance activity

Popularity20

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity80

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 91.8% 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 ~536 days

Recently: every ~546 days

Total

6

Last Release

784d ago

Major Versions

1.0.0 → 2.0.02018-03-24

PHP version history (5 changes)1.0.0PHP >=5.4

2.0.0PHP >=7.2

2.0.2PHP >=7.4

2.1.0PHP >=8.1

2.2.0PHP >=8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/e9577f607eb873bc7cf24bcc4ae052aacc7dc6784d92433f0ada8b7c6ddf307d?d=identicon)[r0mdau](/maintainers/r0mdau)

---

Top Contributors

[![r0mdau](https://avatars.githubusercontent.com/u/3662999?v=4)](https://github.com/r0mdau "r0mdau (78 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 commits)")[![peter279k](https://avatars.githubusercontent.com/u/9021747?v=4)](https://github.com/peter279k "peter279k (1 commits)")

---

Tags

databasefile-storageflatfilejsonnosqlnosql-databasepackagistphpstorage-enginezero-dependency

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/r0mdau-jisly/health.svg)

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

###  Alternatives

[doctrine/orm

Object-Relational-Mapper for PHP

10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database

The Illuminate Database package.

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

MongoDB driver library

1.6k64.0M542](/packages/mongodb-mongodb)[ramsey/uuid-doctrine

Use ramsey/uuid as a Doctrine field type.

90340.3M209](/packages/ramsey-uuid-doctrine)[reliese/laravel

Reliese Components for Laravel Framework code generation.

1.7k3.4M16](/packages/reliese-laravel)

PHPackages © 2026

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