Рекурсивный акроним словосочетания «PHP: Hypertext Preprocessor»

Добро пожаловать на форум PHP программистов!

За последние 24 часа нас посетили 17477 программистов и 1719 роботов. Сейчас ищут 1696 программистов ...

Оглавление

Приступая к работе

Установка и настройка

Общие инструкции по установке Установка на Unix системы Установка на Mac OS X Установка в системах Windows Установка на платформах Cloud Computing Менеджер процессов FastCGI (FPM)Установка расширений PECL Проблемы?Конфигурация запуска

Справочник языка

Основы синтаксиса Типы Переменные Константы Выражения Операторы Управляющие конструкции Функции Классы и объекты Пространства имен Errors Исключения Generators Ссылки. Разъяснения Предопределённые переменные Предопределённые исключения Встроенные интерфейсы и классы Контекстные опции и параметры Поддерживаемые протоколы и обработчики (wrappers)

Безопасность

Вступление Общие рассуждения Если PHP установлен как CGI Если PHP установлен как модуль Apache Безопасность файловой системы Безопасность баз данных Сообщения об ошибках Использование глобальных переменных (Register_Globals)Данные, введенные пользователем Волшебные кавычки Сокрытие PHP Необходимость обновлений

Отличительные особенности

HTTP-аутентификация в PHP Cookies Сессии Работа с XForms Загрузка файлов на сервер Работа с удаленными файлами Работа с соединениями Постоянные соединения с базами данных Безопасный режим Использование PHP в командной строке Сборка мусора DTrace Dynamic Tracing

Справочник функций

Ядро PHP: Руководство хакера

Preface Memory management Working with Variables Writing Functions Writing Classes Working with Resources Working with INI settings Working with streams The "counter" Extension - A Continuing Example The PHP 5 build system Extension structure PDO Driver How-To Extension FAQs Zend Engine 2 API reference Zend Engine 2 Opcodes Zend Engine 1

ЧАВО

Общая информация Списки рассылки Получение PHP Вопросы по Базам данных Установка Проблемы сборки Использование PHP Хэширование паролей PHP и HTML PHP и COM Переход с PHP 4 на PHP 5 Разные вопросы

Appendices

История PHP и смежных проектов Migrating from PHP 5.6.x to PHP 7.0.x Migrating from PHP 5.5.x to PHP 5.6.x Migrating from PHP 5.4.x to PHP 5.5.x Переход с PHP 5.3.x на PHP 5.4.x Переход c PHP 5.2.x на PHP 5.3.x Переход с PHP 5.1.x на PHP 5.2.x Переход с PHP 5.0.x на PHP 5.1.x Переход с PHP 4 на PHP 5.0.x Classes and Objects (PHP 4)Отладка в PHP Опции конфигурации Директивы php.ini Список/классификация расширений Список псевдонимов функций Список зарезервированных слов Список типов ресурсов Список доступных фильтров Список поддерживаемых транспортных протоколов Таблица сравнения типов в PHP Список меток (tokens) парсера Руководство по именованию Об этом руководстве Creative Commons Attribution 3.0 Алфавитный список Список изменений

sqlite_query - Выполняет запрос к базе данных и возвращает идентификатор результата

Вернуться к: SQLite

sqlite_query

SQLiteDatabase::query

(PHP 5 < 5.4.0, PECL sqlite >= 1.0.0)

sqlite_query -- SQLiteDatabase::query — Выполняет запрос к базе данных и возвращает идентификатор результата

Описание

resource sqlite_query ( resource $dbhandle , string $query [, int $result_type = SQLITE_BOTH [, string &$error_msg ]] )

resource sqlite_query ( string $query , resource $dbhandle [, int $result_type = SQLITE_BOTH [, string &$error_msg ]] )

Объектно-ориентированный стиль (метод):

public SQLiteResult SQLiteDatabase::query ( string $query [, int $result_type = SQLITE_BOTH [, string &$error_msg ]] )

Выполняет SQL-запрос query к указанному дескриптору базы данных.

Список параметров

dbhandle

Ресурс базы данных SQLite, полученный из функции sqlite_open() в случае использования процедурного подхода. Этот параметр не требуется при использовании объектно-ориентированного подхода.

query

Выполняемый запрос.

Данные в запросе должны быть корректно экранированы.

result_type

Необязательный параметр result_type принимает константу, определяющую, как будет индексирован возвращаемый массив. При использовании SQLITE_ASSOC будет возвращен ассоциативный массив, а при использовании SQLITE_NUM - числовой. SQLITE_BOTH вернет массив как с ассоциативными, так и с числовыми индексами. Значением по умолчанию для этой функции является SQLITE_BOTH.

error_msg

Указанная переменная будет заполнена в случае возникновения ошибки. Это особенно важно, так как ошибки синтаксиса SQL не возвращаются функцией sqlite_last_error().

Замечание: Поддерживаются два альтернативных синтаксиса для совместимости с другими расширениями баз данных (например, MySQL). Предпочитаемая форма - первая, в которой параметр dbhandle является первым параметром функции.

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

Эта функция возвращает идентификатор результата запроса или FALSE в случае возникновения ошибки. Для запросов, возвращающих данные, этот идентификатор может использоваться в качестве аргумента таких функций как sqlite_fetch_array() и sqlite_seek().

Независимо от типа запроса, в случае возникновения ошибки эта функция возвращает FALSE.

sqlite_query() возвращает буферизованный результирующий набор, по которому также можно перемещаться в различных направлениях. Её следует использовать для запросов, возвращающих относительно небольшое количество записей, если вам необходим случайный доступ к записям. Дескриптор буферизованного результата выделит память для всего возвращаемого результата и не возвратит ее, пока весь результат не будет полностью получен. Если вам необходим только последовательный доступ к записям, рекомендуется использовать намного более производительную функцию sqlite_unbuffered_query().

Список изменений

Версия	Описание
5.1.0	Добавлен параметр `error_msg`

Примечания

Внимание

SQLite выполнит несколько запросов, разделенных точкой с запятой, что можно использовать, например, для выполнения запросов, прочитанных из файла. Однако, это работает только в случае, если результат функции не используется - если он используется, то будет выполнен только первый запрос. Функция sqlite_exec() всегда выполняет все запросы.

При выполнении нескольких запросов, эта функция возвращает FALSE в случае ошибки, иначе возвращаемое значение будет неопределенным (оно может быть как TRUE, так и идентификатором результата запроса).

Смотрите также

sqlite_unbuffered_query() - Выполняет запрос без буферизации результатов
sqlite_array_query() - Выполняет запрос к базе данных и возвращает результат в виде массива

Вернуться к: SQLite