Глобальные методы


В глобальную часть входят все модули, которые лежат по пути /miwix-admin/global.

В папке globals ничего менять или добавлять не рекомендуется, так как все изменения исчезнут после обновления CMS MIWIX, редактируйте исходный код только на свой страх и риск.

Управляется папка globals через статический класс g, примеры использования можете посмотреть в разделе "Шаблоны" и в данном разделе ниже. Любой метод, используемый в данном классе, создается только один раз от получения запроса до отправки ответа клиенту.

Управление базой данных (БД):

Вызов через глобальный класс g::db()->query()

  • query - выполняет запрос к базе данных;
  • insertId - возвращает автоматически генерируемый ID, используя последний запрос;
  • getAll - получить массив строк;
  • getCol - получить массив значений определенного столбца;
  • getRow - получить ассоциативный массив строчки из БД;
  • getOne - получить первое значение из запроса БД;

Примеры использования:

g::db()->query("SELECT * FROM `products` WHERE `id` = ?i", $id);
g::db()->query("INSERT INTO `products` (`id`, `name`) VALUES (?a)", $array);
g::db()->query("UPDATE `products` SET ?u WHERE `id` = ?i", $array, $id);

Аргументы для безопасного использования БД:

  • ?n - передача ключа при запросе к базе данных;
  • ?s - передача значения типа string;
  • ?i - передача значения типа int;
  • ?a - передача значений в массиве для запроса INSERT INTO;
  • ?u - передача ключей и значений для запроса UPDATE;
  • ?p - используется для передачи запроса;

 

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

 

Описание методов запроса get, post, put, delete, update, delete.

Методы запроса реализованы через общий класс request, ниже описаны все методы request, где methods - это метод, к которому вы обращаетесь.

  • g::request()->methods()->get($key = null) - получение значений из метода запроса. Если ключ не передан, то возращает массив метода запроса. Если значение отсутствует, то возвращает false.
  • g::request()->methods()->set($key, $data = null) - добавление значений из метода запроса. Если первым аргументом передать массив и дату оставить пустой, то в методе запроса запишутся ключи и значения из массива. Вторым параметром можно передавать как массив, так и строку.
  • g::request()->methods()->update($key, $data) - обновляет значения из метода запроса. Если в методе запроса не существует ключа, который вы хотите обновить, то вернет false.
  • g::request()->methods()->remove($key) - удаляет значение из метода запроса. При успешном удалении вернет true и при отсутствии значения по ключу, вернут false.
  • g::request()->methods()->isCheckExistence($key) - проверка на существование значений по ключу из метода запроса. Если существует, вернет true и при отсутствии значения по ключу, вернет false.
  • g::request()->methods()->clear() - очистка значений из метода запроса.
  • g::request()->methods()->isErrors() - проверяет произошла ошибка при операциях в методах запроса. При отсутствии ошибок возвращает false, при наличии ошибок вернет true.

 

Методы работы с header запросами:

 

  • g::request()->header()->get($key = null) - получение значений из header запроса. Если Вы не передали ключ в метод, то вернет массив заголовков запроса. Если значение отсутствует, то возвращает false.
  • g::request()->files()->get($key = null) - получает список файлов, переданных на сервер. Если Вы не передали ключ в метод, то вернет массив файлов. Если значение отсутствует, то возвращает false.

 

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

 

Объект data, header и files наследуются от общего класса response. Объект data используется для вывода данных в шаблон или json ответ. Объект header отправляет заголовки клиенту. Описание производится на примере объекта data.

  • g::response()->data()->get($key = null) - Если ключ не передан, то возращает массив data. Если значение отсутствует, то возвращает false.
  • g::response()->data()->set($key, $data = null) - добавление значений в data. Вторым параметром можно передавать как массив, так и строку. Если значение уже существует, метод вернет false.
  • g::response()->data()->update($key, $data) - обновляет значения из data. Если в data не существует ключа, который вы хотите обновить, то вернет false.
  • g::response()->data()->remove($key) - удаляет значения из data. При успешном удалении вернет true и при отсутствии значения по ключу, вернет false.
  • g::response()->data()->clear() - очищает все значения из массива data.
  • g::response()->data()->isCheckExistence($key) - проверка на существование значений по ключу из data. Если существует, вернет true, и при отсутствии значения по ключу вернет false.

 

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

 

  • g::stack()->get($key = null) - получение значений из stack. Если ключ не передан, то возращает массив stack. Если значение отсутствует, то возвращает false.
  • g::stack()->set($key, $data = null) - добавление значений из stack. Если первым аргументом перадать массив и дату оставить пустой, то в stack запишутся ключи и значения из массива. Вторым параметром можно передавать как массив, так и строку
  • g::stack()->update($key, $data) - обновляет значения из stack. Если в stack не существует ключа, который вы хотите обновить, то вернет false.
  • g::stack()->remove($key) - удаляет значения из stack. При успешном удалении вернет true, и при отсутствии значения по ключу вернет false.
  • g::stack()->isCheckExistence($key) - проверка на существование значений по ключу из stack. Если существует вернет true, и при отсутствия значения по ключу вернет false.