NinjaDB

Description

A lightweight, expressive query builder for WordPress. NInjaDB use the same $wbdp instance and methods, It will help you to write $wpdb queries easily and expressively. At least PHP 5.3 is required.

It has some advanced features like:
– Query Like Laravel Basic Queries
– Where, orWhere methods
– Search data in all the columns or specific columns
– Easily Implement Pagination
– use insert, update or delete methods expressively.

The syntax is quite similar to Laravel’s query builder.

Simple Query:

The query below returns the row where id = 3, null if no rows.

$row = ninjaDB('my_table')->find(3);

Full Queries:

$query = ninjaDB('my_table')->where('post_author', '=', 1);  // for equal you can just use where('post_author, 1);
// Get result as array of objects
$query->get();

Full Usage API

### Initiate

// Select a table
$query = ninjaDB()->table('post');  // post is the table name without prefix;

OR You can pass your table name as an argument

// Select a table
$query = ninjaDB('my_table');  // post is the table name without prefix;<h3>Query</h3>

Get Easily

The query below returns the (first) row where id = 3, null if no rows.

$row = ninjaDB('my_table')->find(3);

Access your row like, echo $row->name. If your field name is not id then pass the field name as second parameter ninjaDB('my_table')->find(3, 'author_id');.

The query below returns the all rows as array of objects where author_id = 3, null if no rows.

$result = ninjaDB('my_table')->findAll('author_id', 3);

Select

$query = ninjaDB('my_table')->select('*');

Multiple Selects

->select(array('myfield1', 'myfield2', 'amyfield3'));

Using select method multiple times select('a')->select('b') will also select a and b. Can be useful if you want to do conditional selects (within a PHP if).

Get All

Return an array of objects.

$query = ninjaDB('my_table')->where('author_id', 1);
$result = $query->get();

You can loop through it like:

foreach ($result as $row) {
    echo $row->name;
}

Get First Row

$query = ninjaDB('my_table')->where('author_id', 1);
$row = $query->first();

Returns the first row, or null if there is no record. Using this method you can also make sure if a record exists. Access these like echo $row->name.

Get Rows Count, MAX, MIN, AVerage, SUM

$query = ninjaDB('my_table')->where('author_id', 1);
$count = $query->count();
$max = $query->max('views'); // Where `views` is the column name and all these will return integer / float
$min = $query->min('views');
$avg = $query->avg('views');
$avg = $query->avg('views');
$sum = $query->sum('views');

Where

Basic syntax is (fieldname, operator, value), if you give two parameters then = operator is assumed. So where('name', 'jewel') and where('name', '=', 'jewel') is the same.

ninjaDB('my_table')
    ->where('name', '=', 'jewel')
    ->whereNot('age', '>', 25)
    ->orWhere('description', 'LIKE', '%query%');

whereIn

ninjaDB('my_table')
    ->whereIn( 'id', array(1,2,3) ) 
    ->get();

Limit and Offset

->limit(30);
->offset(10);

// or you can use aliases
->take(30);
->skip(10);

Order By

->orderBy('id', 'ASC');

Insert

$data = array(
    'name' => 'Jewel',
    'description' => 'Hello, There'
);
$insertId = ninjaDB('my_table')->insert($data);

insert() method returns the insert id. optionally you can pass $format of your data as `->insert($data, $format);` where `$format` is  an array of formats to be mapped to each of the value in $data

Batch Insert

$data = array(
    array(
          'name' => 'Jewel',
        'description' => 'Hello, There'
    ),
    array(
        'name'        => 'Adre',
        'description' => 'Hello, I am Adre Astrian'
    ),
);
$insertIds = ninjaDB('my_table')->batch_insert($data);

In case of batch insert, it will return an array of insert ids.

Update

$data = array(
    'name' => 'Shahjahan Jewel',
    'description' => 'Hello, There'
);

ninjaDB('my_table')->where('id', 5)->update($data);

Will update the name field to Shahjahan Jewel and description field to Hello, There where id = 5.

Delete

ninjaDB('my_table')->where('id', '>', 5)->delete();

Will delete all the rows where id is greater than 5.

If you find any typo or extend any functionality then please edit and send a pull request.

TODO

• [ ] join()
• [x] whereIN()
• [ ] whereNotIN()
• [ ] whereBetween
• [ ] whereNotBetween
• [ ] Having
• [ ] GroupBy
• [x] selectDistinct

If you would like to implement any of the TODO please feel free to do and do a pull request

And, finally, consider to contribute to this plugin here.