https://github.com/Lazer-Database/Lazer-Database
PHP flat file database to store data with JSON
https://github.com/Lazer-Database/Lazer-Database
database db file flat json php
Last synced: 7 months ago
JSON representation
PHP flat file database to store data with JSON
- Host: GitHub
- URL: https://github.com/Lazer-Database/Lazer-Database
- Owner: Lazer-Database
- License: mit
- Created: 2013-02-20T13:27:27.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2023-11-28T16:45:25.000Z (almost 2 years ago)
- Last Synced: 2025-03-20T21:24:47.586Z (8 months ago)
- Topics: database, db, file, flat, json, php
- Language: PHP
- Homepage:
- Size: 386 KB
- Stars: 281
- Watchers: 13
- Forks: 37
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
- awesome-distributed-system-projects - Lazer - a PHP flat file database based on JSON files
README
Lazer - php flat file database based on JSON files
====================================
[](https://github.com/Lazer-Database/Lazer-Database/actions/workflows/unit.yml)
[](https://packagist.org/packages/greg0/lazer-database#latest)
PHP Library to use JSON files like a database.
Functionality inspired by ORM's
Requirements
------------
- PHP 7.1+
- Composer
Installation
------------
Easiest way to install `Lazer Database` is to use Composer. Of course you can use your own autoloader but you must configure it properly by yourself. You can find my Package on [Packagist.org](https://packagist.org/packages/greg0/lazer-database).
To add library to your dependencies, execute:
```
composer require greg0/lazer-database
```
Tests
-----
Easiest way to run unit tests is to use composer script
```
composer run test
```
You can also use docker
```shell
docker build -t lazer-db .
docker run -it --rm lazer-db
```
Structure of table files
-------
`table_name.data.json` - table file with data
`table_name.config.json` - table file with configuration
Basic Usage
-----------
First of all you should define constant `LAZER_DATA_PATH` containing absolute path to folder with JSON files:
```php
define('LAZER_DATA_PATH', realpath(__DIR__).'/data/'); //Path to folder with tables
```
Then set up namespace:
```php
use Lazer\Classes\Database as Lazer; // example
```
### Methods
##### Chain methods
- `setField()` - set value of field (alternative to magic `__set()`)
- `limit()` - returns results between a certain number range. Should be used right before ending method `findAll()`.
- `orderBy()` - sort rows by key in order, can order by more than one field (just chain it).
- `groupBy()` - group rows by field.
- `where()` - filter records. Alias: `and_where()`.
- `orWhere()` - other type of filtering results.
- `with()` - join other tables by defined relations
##### Ending methods
- `getField` - get value of field (alternative to magic `__get()`)
- `issetField` - check if field is isset (alternative to magic `__isset()`)
- `addFields()` - append new fields into existing table
- `deleteFields()` - removing fields from existing table
- `set()` - get key/value pair array argument to save.
- `save()` - insert or Update data (automatically detect if it needs an insert or update).
- `insert()` - force an insert.
- `delete()` - deleting data.
- `relations()` - returns array with table relations
- `config()` - returns object with configuration.
- `fields()` - returns array with fields name.
- `schema()` - returns assoc array with fields name and fields type `field => type`.
- `lastId()` - returns last ID from table.
- `find()` - returns one row with specified ID.
- `findAll()` - returns rows.
- `asArray()` - returns data as indexed or assoc array: `['field_name' => 'field_name']`. Should be used after ending method `findAll()` or `find()`.
- `count()` - returns the number of rows. Should be used after ending method `findAll()` or `find()`.
### Create database
```php
Lazer::create('table_name', array(
'id' => 'integer',
'nickname' => 'string',
{field_name} => {field_type}
));
```
More information about field types and usage in PHPDoc
### Remove database
```php
Lazer::remove('table_name');
```
### Check if a database exists
```php
try{
\Lazer\Classes\Helpers\Validate::table('table_name')->exists();
} catch(\Lazer\Classes\LazerException $e){
//Database doesn't exist
}
```
### Select
#### Multiple select
```php
$table = Lazer::table('table_name')->findAll();
foreach($table as $row)
{
print_r($row);
}
```
#### Single record select
```php
$row = Lazer::table('table_name')->find(1);
echo $row->id; // or $row->getField('id')
```
Type ID of row in `find()` method.
You also can do something like that to get first matching record:
```php
$row = Lazer::table('table_name')->where('name', '=', 'John')->find();
echo $row->id;
```
### Insert
```php
$row = Lazer::table('table_name');
$row->nickname = 'new_user'; // or $row->setField('nickname', 'new_user')
$row->save();
```
Do not set the ID.
### Update
It's very smilar to `Inserting`.
```php
$row = Lazer::table('table_name')->find(1); //Edit row with ID 1
$row->nickname = 'edited_user'; // or $row->setField('nickname', 'edited_user')
$row->save();
```
You can also set many field by simple key-value array
```php
$row = Lazer::table('table_name')->find(1); //Edit row with ID 1
$row->set(array(
'nickname' => 'user',
'email' => 'user@example.com'
));
$row->save();
```
### Remove
#### Single record deleting
```php
Lazer::table('table_name')->find(1)->delete(); //Will remove row with ID 1
// OR
Lazer::table('table_name')->where('name', '=', 'John')->find()->delete(); //Will remove John from DB
```
#### Multiple records deleting
```php
Lazer::table('table_name')->where('nickname', '=', 'edited_user')->delete();
```
#### Clear table
```php
Lazer::table('table_name')->delete();
```
### Relations
To work with relations use class Relation
```php
use Lazer\Classes\Relation; // example
```
#### Relation types
- `belongsTo` - relation many to one
- `hasMany` - relation one to many
- `hasAndBelongsToMany` - relation many to many
#### Methods
##### Chain methods
- `belongsTo()` - set relation belongsTo
- `hasMany()` - set relation hasMany
- `hasAndBelongsToMany()` - set relation hasAndBelongsToMany
- `localKey()` - set relation local key
- `foreignKey()` - set relation foreign key
- `with()` - allow to work on existing relation
##### Ending methods
- `setRelation()` - creating specified relation
- `removeRelation()` - remove relation
- `getRelation()` - return informations about relation
- `getJunction()` - return name of junction table in `hasAndBelongsToMany` relation
#### Create relation
```php
Relation::table('table1')->belongsTo('table2')->localKey('table2_id')->foreignKey('id')->setRelation();
Relation::table('table2')->hasMany('table1')->localKey('id')->foreignKey('table2_id')->setRelation();
Relation::table('table2')->hasAndBelongsToMany('table1')->localKey('id')->foreignKey('id')->setRelation(); // Junction table will be crete automaticly
```
#### Remove relation
```php
Relation::table('table1')->with('table2')->removeRelation();
```
#### Get relation information
You can do it by two ways. Use Standard Database class or Relation but results will be different.
```php
Relation::table('table1')->with('table2')->getRelation(); // relation with specified table
Lazer::table('table1')->relations(); // all relations
Lazer::table('table1')->relations('table2'); // relation with specified table
```
Description
-----------
For some examples please check
[Examples](docs/examples.md) and [Tutorial](docs/tutorial.md) file.
More informations you can find in PHPDoc, I think it's documented very well.
E-mail:
If you like and using/want to use my repo or you have any suggestions I will be greatful for sending me few words on e-mail.