Фремворк Limb

Отредактируйте страницу и нажмите «Сохранить». Прочтите справочную страницу для ознакомления с синтаксисом вики. Пожалуйста, редактируйте только в том случае, если планируете улучшить содержимое. Если вы просто хотите потестировать что-либо, воспользуйтесь специальной страницей: PlayGround.

====== 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>

Пожалуйста, введите код подтверждения, чтобы доказать, что вы не робот:

     __   __ __  __  __   __    ___ 
 __ / /  / // / / / / /  / /   / _ \
/ // /  / _  / / /_/ /  / /__ / , _/
\___/  /_//_/  \____/  /____//_/|_|

Пожалуйста, оставьте это поле пустым:

Сводка изменений

Примечание: редактируя эту страницу, вы соглашаетесь на использование своего вклада на условиях следующей лицензии: CC Attribution-Share Alike 4.0 International

Фремворк Limb

Инструменты пользователя

Инструменты сайта

Инструменты страницы