Онлайн-руководство разработчика NetCat
Модуль «Поиск по сайту» 12.2.1Начало работы с модулем 12.2.2Язык запросов 12.2.3Способы хранения индекса 12.2.4Интерфейс модуля в панели управления сайтом 12.2.5Области индексирования 12.2.6Области HTML-страниц 12.2.7Области поиска на сайте 12.2.8Индексирование по расписанию, запуск индексирования в фоновом режиме 12.2.9Правила индексирования 12.2.10Постановка задачи переиндексирования в очередь 12.2.11Интеграция модуля в макеты дизайна сайта 12.2.12Простая форма поиска 12.2.13Расширенная форма поиска 12.2.14Вывод результатов поиска 12.2.15Стилизация списка подсказок 12.2.16Расширенные настройки 12.2.17Разработка расширений модуля 12.2.18Обзор архитектуры модуля 12.2.19Обработчики документов различных типов 12.2.20Текстовые фильтры 12.2.21Анализаторы текста 12.2.22Корректировщики запросов 12.2.23Подключение других поисковых систем 12.2.24Решение проблем с поиском 12.2.25Решение проблем с индексированием 12.2.26Справочник API

API

$nc_core->db->query($query, $output = OBJECT, $index_field = null)

выполнение произвольного MySQL-запроса и попытка получения результата

Аргументы

  • $query
    Запрос в базу данных
  • $output
    Параметр используется опционально. При его вводе данные будут представлены в виде массива:
    ARRAY_N — нумерованный
  • $index_field (опционально)
    Индекс поля, которое используется в качестве ключа в массиве результирующей выборки из базы данных

Возвращаемое значение

  • bool|int

После выполнения запросов доступны методы

  • $nc_core->db->num_rows
    количество строк, возвращённых за последний запрос.
  • $nc_core->db->insert_id
    возвращает ID последнего добавленного элемента. Для операции INSERT.
  • $nc_core->db->rows_affected
    количество затронутых строк во время последнего запроса. Для операций: INSERT, UPDATE, DELETE.
  • $nc_core->db->num_queries
    отслеживает количество «реальных» запросов было выполнено в течение жизни текущего скрипта.
  • $nc_core->db->debug_all
    если установить значение в true ($nc_core->db->debug_all = true;), будут выведены все запросы и все результаты скрипта.

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

<?php
// Получаем объект nc_core
$nc_core = nc_Core::get_object();

// Пример №1
// Запрос к таблице БД
// Используется нумерованный массив
$nc_core->db->query("SELECT * FROM `User`", ARRAY_N );
$arr = $nc_core->db->last_result;

if (!empty($arr)) {
    foreach ($arr as $row) {
        // выводятся значения из 11 столбца
        echo $row[10];
    }
}

// Вывод одного объекта
// выводятся значения из 1 строки 12 столбца
echo $arr[0][11];
// вывод данных из 16 строки, 1 столбца
echo $arr[15][0];

// Пример №2
// Запрос к таблице БД
$nc_core->db->query("SELECT * FROM `User`" );
$arr = $nc_core->db->last_result;

// вывод результатов
if (!empty($arr)) {
    foreach ($arr as $row) {
        // выводятся значения из поля Login
        echo $row->Login;
        // выводятся значения из поля Email
        echo $row->Email;
    }
}
// Вывод одного объекта
// выводятся значения из 1 строки, поля Login
echo $arr[0]->Login;
// выводятся значения из 1 строки, поля Password
echo $arr[0]->Password;

// Пример №3
// Добавление данных в БД
$nc_core->db->query("INSERT INTO `User`
                   (`Password`, `Login`, `Email`)
                   VALUES
                   ('12345', 'user', 'user@example.com')
                   ");
// Получаем User_ID добавленного пользователя
$nc_core->db->insert_id;

// Пример №4
// Обновление данных БД
$nc_core->db->query("UPDATE `User`
                    SET
                    `Password` = '123459',
                    `Email`    = 'user2@example.com'
                    WHERE
                    `User_ID`  = 1
                    ");
// Получаем количество обновлённых строк
$nc_core->db->rows_affected;

// Пример №5
// Удаление данных из БД
$nc_core->db->query("DELETE FROM `User` WHERE `Email` = 'user2@example.com'");

// Пример №6
// Использование третьего параметра
$arr = $nc_core->db->query("SELECT * FROM `User`", ARRAY_N, 'Checked');
//Вывод значения из первой строки второго столбца
echo $arr[0][1];

См. также

  • $nc_core->db->get_row() — метод получает данные из определенной строки таблицы в базе данных
  • $nc_core->db->get_var() — метод получает одну переменную из базы данных или ранее кэшированных результатов
  • $nc_core->db->get_results() — метод возвращает набор результатов выполненного запроса к базе данных
  • $nc_core->db->get_col_info() — метод отображает мета-информацию о поле из последнего запроса.
  • $nc_core->db->get_col() — метод получает данные из определенного столбца таблицы в базе данных
Описание проекта