Класс Data

Класс для создания новых записей в любых таблицах базы данных, а также для обновления и извлечения записей из таблиц. Методы класса работают единовременно только с одной записью.

Во всех методах класса применяется параметр $table — полное имя таблицы, включая префикс базы данных. Этот параметр можно также получить с помощью метода Blox::getTbl($tpl).

Data::insert($table, $data)

Метод для создания в таблице новой строки.

  • Возвращает true или false.

  • $table — имя таблицы (строка).

  • $data — данные, которые нужно внести в запись сразу во время ее создания (массив). Формат имяСтолбца=>значение. Если таблица не является автоинкрементной, данный параметр необходимо указывать обязательно.

Data::replace($table, $data)

Метод для замены строки или создания новой строки аналогично методу Data::insert().

Data::get($table, $wdata)

Метод для извлечения одной строки таблицы.

  • Возвращает данные строки таблицы в формате имяСтолбца=>значение (массив).

  • $table — имя таблицы (строка).

  • $wdata — ключевые данные (массив). Массив для формирования запроса WHERE в sql выражении. Ключами массива являются имена столбцов.

Data::update($table, $data, $wdata)

Метод для изменения данных в строке таблицы.

  • Возвращает true или false.

  • $table — имя таблицы (строка).

  • $data — данные, которые подлежат изменению (массив). Формат имяСтолбца=>значение.

  • $wdata — ключевые данные (массив). Массив для формирования запроса WHERE в sql выражении. Ключами массива являются имена столбцов.

Data::delete($table, $wdata)

Метод для удаления одной строки таблицы.

  • Возвращает true или false.

  • $table — имя таблицы (строка).

  • $wdata — ключевые данные. Массив для формирования запроса WHERE в sql выражении. Ключами массива являются имена столбцов.


Примечания

  • При обращении к базе данных с помощью методов класса Data, все данные автоматически параметризуются, поэтому никаких специальных мероприятий по защите от sql-инъекций делать не нужно. О параметризации можно узнать подробнее в статье Класс Sql. В той же статье даны универсальные методы работы с таблицами базы данных, в которых, правда, приходится специально параметризовать данные и следить за их типом, в отличие от методов класса Data.


См. также