From In-Portal Developers Guide

Current revision

База данных
Статьи в этой категории
Работа с базой данных Работа с временными таблицами Useful SQLs Счётчики

При работе с базой данных следует использовать экземпляр класса kDBConnection доступный через атрибут Conn почти у каждого класса. В общем случае это выглядит так:

$result = $this->Conn->MethodName($params);

Вместо MethodName можно использовать методы описанные далее. Универсальная проверка на присутствие данных в ответе на запрос может выглядеть так:

if ($result) {
	// код будет выполнен только в случае удачного
	// завершения запроса и при наличии данных
}

При изменении данных в базе в ручную не забывайте изменять данные в связанных таблицах, иначе может нарушится целостность данных (data integrity) в базе.

Выборка данных из базы

При неудачной выборке будет возвращён false или пустой массив.

Обработка результатов запроса

Изменение данных в базе

Добавление колонок в таблицу

При добавлении колонок в таблицы следует придерживаться следующих правил в указании опций колонок исходя из содержания будущей колонки:

• сумма (деньги) - тип DECIMAL(20,2) и NOT NULL
• дата (timestamp) - тип INT(11) и NULL
• короткий текст (имя/фамилия, до 8KB) - VARCHAR(255) и NOT NULL
• текст средней длинны (описание, от 8KB байт и до 64KB) - TEXT и NULL
• длинный текст (описание, от 64KB и до 4MB) - LONGTEXT и NULL

В следующих случаях нужно всегда ставить INDEX на колонку:

• колонка содержит дату;
• колонка содержит статус записи, напр. Active/Disabled;
• колонка указывает на то, что запись основная, т.е. IsPrimary;
• по колонке будет делаться сортировка и колонка цифровая, напр. Order, Priority;
• по колонке может быть сделать JOIN;
• колонка является ForeignKey.

В каждой таблице должен быть основной ключ (primary key). Этот ключ всегда должен состоять из одной цифровой колонки и не должен быть UNSIGNED.

Значение по умолчанию

Значение по умолчанию должно явно указано в декларации поля добавлением DEFAULT ... части в SQL.

Использование слова NULL

Все колонки типов TINYTEXT, TEXT, LONGTEXT должны быть NULL без DEFAULT значения (требование в MySQL5).

Использование слова UNSIGNED

Если присутствует 100% уверенность в том, что в колонке не может быть отрицательных значений, то колонку нужно делать UNSIGNED. Колонки, где храниться timestamp нельзя делать UNSIGNED в тех случаях, когда

• в колонке с датой может быть дата меньше 1 января 1970 года;
• в колонке находиться только время (без даты).

См. также

• Useful SQLs
• Нумерация рядов в MySQL