====== lmbSimpleDb ======

Класс **lmbSimpleDb** - небольшой фасад для пакета, который позволяет упростить выполнение простых CRUD запросов.



===== Инициализация =====

Конструктор класса lmbSimpleDb принимает объект подключения к базе данных (connection):

<code php>
  lmb_require('limb/dbal/src/lmbSimpleDb.class.php');
  $connection = lmbToolkit :: instance()->getDefaultDbConnection();
  $db = new lmbSimpleDb($connection);
</code>

Более простым способом создания объекта lmbSimpleDb с подключением к базе данных по-умолчанию является вызов метода [[lmbDBAL|lmbDBAL]] :: db(), например:

<code php>
 $db = lmbDBAL :: db();
</code>

Или, если вы используете частное подключение:
<code php>
 $db = lmbDBAL :: db($my_connection);
</code>



===== Выполнение select-запросов =====

lmbSimpleDb содержит следующие методы для выполнения select-запросов:

  * **select($table, $criteria = null, $order = array())** - выполняет запрос в таблицу $table с условием $criteria, сортируя записи по признакам $order. Возвращает набор данных ($record_set), поддерживающий интерфейс lmbDbRecordSet
  * **selectRecord($table, $criteria = null)**  - выполняет запрос в таблицу $table с условием $criteria и возвращает первую запись или null, если ничего не было выбрано. Возвращает объект записи ($record), поддерживающий интерфейс lmbDbRecord
  * **count($table, $criteria = null)** - подсчитывает количество записей из таблицы $table при выборке с условием $criteria.

(см. [[Driver|раздел Driver]] об интерфейсах lmbDbRecordSet и lmbDbRecord)

В качестве **$criteria** можно передавать как часть $sql кода, так и объект [[criteria|Criteria]].

Например:
<code php>
  $db = new lmbSimpleDb($conn);
  $rs = $db->select('article', 'author_id = '. (int)$author_id);
  // или
  $rs = db->select('article', new lmbSQLCriteria('author_id = '. (int)$author_id));
</code>

Строковые данные в целях безапасности имеет смысл квотировать:

<code php>
  $rs = $db->select('article', 'title LIKE '. $db->quote("%" . $search_title));
</code>

В качестве **$order** передается массив вида array('field' => 'order_type'), например:
<code php>
  $db = new lmbSimpleDb($conn);
  $rs = $db->select('article', '', array('year' => 'DESC', 'title' => 'ASC'));
</code>

Зачастую вместо параметра $order удобнее все же использовать метод sort() самого record_set-а:
<code php>
  $db = new lmbSimpleDb($conn);
  $rs = $db->select('article')->sort(array('year' => 'DESC', 'title' => 'ASC'))->paginate(0, 5);
</code>

Здесь мы выбрали первые 5 записей из таблицы article отсортировав из по году по убыванию и по загововку в алфавитном порядке.

Опять же вместо lmbSimpleDb :: count() можно использовать метод count() record_set-а, например:
<code php>
  $db = new lmbSimpleDb($conn);
  $number = $db->count('article', 'author_id = '. $author_id);
  // или можно 
  $number = $db->select('article', 'author_id = '. $author_id)->count();
</code>

===== Выполнение запросов на модификацию базы данных =====

lmbSimpleDb содержит следующие методы для выполнения модификационных запросов:
  * **insert($table, $values, $primary_key = 'id')** - вставляет в таблицу $table запись со значениями полей $values. Возвращает значение поля $primary_key вставленной записи, если такое поле не задано в $values.
  * **update($table, $values, $criteria = null)**  - обновляет записи таблицы $table, которые соответствуют необязательному условию $criteria, на значения полей $values
  * **delete($table, $criteria = null)**  - удаляет записи из таблицы $table, которые соответствуют необязательному условию $criteria
  * **truncateDb()** - очищащает все таблицы базы данных
  * **countAffected()** - возвращает количество записей в базе данных, затронуных в результате последнего запроса на модификацию.

Примеры:
<code php>
  $db->delete('news');
  $db->delete('article', new lmbSQLCriteria('author_id = '. $author_id));
  echo 'Removed ' . $db->countAffected() . ' articles of this author';
  
  $db->insert('user', array('login' => $login, 'password' => $password));

  $db->update('user', array('password' => 'other_secret'), 'id = ' . $user_id);
</code>


===== Прочие методы =====

lmbSimpleDb также содержит alias-ы методов для управления транзакциями:

  * **begin()** - начинает транзакцию
  * **commit()** - завершает транзацию
  * **rollback()** - откатывает назад транзакцию

А также методы:
  * **disconnect()** - отключается от базы данных
  * **quote($value)** - применяет родное для базы данных квотирование(quote) строки. Используется для безопасного составления условий.

Например:
<code php>
  $db = new lmbSimpleDb($conn);
  $rs = $db->select('user', 'login = '. $db->quote($login));
</code>