Title: NinjaDB
Author: Shahjahan Jewel
Published: <strong>26.09.2017</strong>
Last modified: 26.09.2017

---

Поиск плагинов

![](https://ps.w.org/ninjadb/assets/banner-772x250.png?rev=1736466)

Этот плагин **не тестировался с последними 3 основными выпусками WordPress**. Скорее
всего, он уже не поддерживается и может быть несовместим с текущими версиями WordPress.

![](https://ps.w.org/ninjadb/assets/icon-256x256.png?rev=1736466)

# NinjaDB

 Автор: [Shahjahan Jewel](https://profiles.wordpress.org/techjewel/)

[Скачать](https://downloads.wordpress.org/plugin/ninjadb.zip)

 * [Детали](https://ru.wordpress.org/plugins/ninjadb/#description)
 * [Отзывы](https://ru.wordpress.org/plugins/ninjadb/#reviews)
 *  [Установка](https://ru.wordpress.org/plugins/ninjadb/#installation)
 * [Разработка](https://ru.wordpress.org/plugins/ninjadb/#developers)

 [Поддержка](https://wordpress.org/support/plugin/ninjadb/)

## Описание

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](https://github.com/WpManageNinja/NinjaDB).

## Установка

In the search field type “NinjaDB” and click Search Plugins. Once you’ve found this
plugin you can view details about it such as the point release, rating and description.
Most importantly of course, you can install it by simply clicking “Install Now”.

## Часто задаваемые вопросы

  Installation Instructions

In the search field type “NinjaDB” and click Search Plugins. Once you’ve found this
plugin you can view details about it such as the point release, rating and description.
Most importantly of course, you can install it by simply clicking “Install Now”.

  Where can I find documentation and user guides?

For Expressive Documentation please [follow github repo](https://github.com/WpManageNinja/NinjaDB)

## Отзывы

Нет отзывов об этом плагине.

## Участники и разработчики

«NinjaDB» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад
следующие участники:

Участники

 *   [ Shahjahan Jewel ](https://profiles.wordpress.org/techjewel/)
 *   [ Mahmudul Hasan Arif ](https://profiles.wordpress.org/adreastrian/)

[Перевести «NinjaDB» на ваш язык.](https://translate.wordpress.org/projects/wp-plugins/ninjadb)

### Заинтересованы в разработке?

[Посмотрите код](https://plugins.trac.wordpress.org/browser/ninjadb/), проверьте
[SVN репозиторий](https://plugins.svn.wordpress.org/ninjadb/), или подпишитесь на
[журнал разработки](https://plugins.trac.wordpress.org/log/ninjadb/) по [RSS](https://plugins.trac.wordpress.org/log/ninjadb/?limit=100&mode=stop_on_copy&format=rss).

## Журнал изменений

#### 0.8 — 2017-09-10

 * Initial Release

## Мета

 *  Версия **0.8**
 *  Обновление: **9 лет назад**
 *  Активных установок: **Менее 10**
 *  Версия WordPress ** 4.0 или выше **
 *  Совместим вплоть до: **4.8.30**
 *  Язык
 * [English (US)](https://wordpress.org/plugins/ninjadb/)
 *  [Дополнительно](https://ru.wordpress.org/plugins/ninjadb/advanced/)

## Оценки

Пока что нет ни одного отзыва.

[Ваш отзыв](https://wordpress.org/support/plugin/ninjadb/reviews/#new-post)

[Посмотреть всеотзывы](https://wordpress.org/support/plugin/ninjadb/reviews/)

## Участники

 *   [ Shahjahan Jewel ](https://profiles.wordpress.org/techjewel/)
 *   [ Mahmudul Hasan Arif ](https://profiles.wordpress.org/adreastrian/)

## Поддержка

Есть что сказать? Нужна помощь?

 [Перейти в форум поддержки](https://wordpress.org/support/plugin/ninjadb/)

## Пожертвование

Хотите поддержать улучшение этого плагина?

 [ Пожертвовать на развитие плагина ](https://paypal.me/zalam)