Разработка:lib/storage base.php — различия между версиями
Yumeneco (обсуждение | вклад)  | 
				Yumeneco (обсуждение | вклад)   (→API)  | 
				||
| Строка 43: | Строка 43: | ||
''Возвращаемые значения:''  | ''Возвращаемые значения:''  | ||
* (bool), true если запись удалилась  | * (bool), true если запись удалилась  | ||
| + | * (bool), false если операция не удалась  | ||
| + | |||
| + | ====get($conditions, $fields='*', $strictness=IGNORE_MISSING)====  | ||
| + | Получает запись из БД.  | ||
| + | |||
| + | ''Аргументы:''   | ||
| + | * $conditions(int) - id записи в таблице  | ||
| + | * $fields (string) - название возвращаемых полей, '*' - все.  | ||
| + | * $strictness (constant) -   | ||
| + |     IGNORE_MISSING - если запись не найдена - то функция возвращает false и выводит отладочное сообщение  | ||
| + |     IGNORE_MULTIPLE - вернуть первое значение и игнорировать остальные, если нашлось больше одной записи (не рекомендуется)  | ||
| + |     MUST_EXIST - если запись не найдена, или найдено несколько записей вместо одной, то будет вызвано исключение.  | ||
| + | |||
| + | ''Возвращаемые значения:''  | ||
| + | * (object), если запись нашлась  | ||
| + | * (bool), false если операция не удалась  | ||
| + | |||
| + | ====get_field($conditions,$return, $strictness=IGNORE_MISSING)====  | ||
| + | Возвращает значение поля из БД.  | ||
| + | |||
| + | ''Аргументы:''   | ||
| + | * $conditions(int|array) - id записи|массив полей и значений в таблице  | ||
| + | * $return (string) - название поля в таблице.  | ||
| + | * $strictness (constant) -   | ||
| + |     IGNORE_MISSING - если запись не найдена - то функция возвращает false и выводит отладочное сообщение  | ||
| + |     IGNORE_MULTIPLE - вернуть первое значение и игнорировать остальные, если нашлось больше одной записи (не рекомендуется)  | ||
| + |     MUST_EXIST - если запись не найдена, или найдено несколько записей вместо одной, то будет вызвано исключение.  | ||
| + | |||
| + | ''Возвращаемые значения:''  | ||
| + | * (string), если запись нашлась  | ||
* (bool), false если операция не удалась  | * (bool), false если операция не удалась  | ||
Версия 12:45, 26 ноября 2013
| Плагин | |
| Название | core | 
| Тип | core | 
Содержание
Описание
Родительский класс для справочников
API
insert($dataobject,$quiet=false,$bulk=false)
Вставляет запись в БД.
Аргументы:
- $dataobject (object) - данные для вставки в БД
 - $quiet (bool) - флаг запрета генерации событий, true - запретить, false - разрешить.
 - $bulk (bool) - true если операций последует много, false если обновлено будет всего несколько записей (для производительности).
 
Возвращаемые значения:
- (int), id вставленной записи
 - (bool), false если операция не удалась
 
update($dataobject,$id = NULL,$quiet=false,$bulk=false)
Обновляет запись в БД.
Аргументы:
- $dataobject (object) - данные для вставки в БД
 - $id (int) - id записи в базе, если значение отсутствует id ищется в dataobject.
 - $quiet (bool) - флаг запрета генерации событий, true - запретить, false - разрешить.
 - $bulk (bool) - true если операций последует много, false если обновлено будет всего несколько записей (для производительности).
 
Возвращаемые значения:
- (bool), true если запись обновилась
 - (bool), false если операция не удалась
 
delete($id,$quiet=false)
Удаляет запись из БД.
Аргументы:
- $id (int) - id записи в базе.
 - $quiet (bool) - флаг запрета генерации событий, true - запретить, false - разрешить.
 
Возвращаемые значения:
- (bool), true если запись удалилась
 - (bool), false если операция не удалась
 
get($conditions, $fields='*', $strictness=IGNORE_MISSING)
Получает запись из БД.
Аргументы:
- $conditions(int) - id записи в таблице
 - $fields (string) - название возвращаемых полей, '*' - все.
 - $strictness (constant) -
 
IGNORE_MISSING - если запись не найдена - то функция возвращает false и выводит отладочное сообщение IGNORE_MULTIPLE - вернуть первое значение и игнорировать остальные, если нашлось больше одной записи (не рекомендуется) MUST_EXIST - если запись не найдена, или найдено несколько записей вместо одной, то будет вызвано исключение.
Возвращаемые значения:
- (object), если запись нашлась
 - (bool), false если операция не удалась
 
get_field($conditions,$return, $strictness=IGNORE_MISSING)
Возвращает значение поля из БД.
Аргументы:
- $conditions(int|array) - id записи|массив полей и значений в таблице
 - $return (string) - название поля в таблице.
 - $strictness (constant) -
 
IGNORE_MISSING - если запись не найдена - то функция возвращает false и выводит отладочное сообщение IGNORE_MULTIPLE - вернуть первое значение и игнорировать остальные, если нашлось больше одной записи (не рекомендуется) MUST_EXIST - если запись не найдена, или найдено несколько записей вместо одной, то будет вызвано исключение.
Возвращаемые значения:
- (string), если запись нашлась
 - (bool), false если операция не удалась