XVIII. Функции FrontBase

Введение

Эти функции дают доступ к серверам БД FrontBase. Дополнительно о FrontBase см. https://www.frontbase.com/.

Документация о FrontBase находится на https://www.frontbase.com/cgi-bin/WebObjects/FrontBase.woa/wa/productsPage?currentPage=Documentation.

Поддержка Frontbase была введена в PHP 4.0.6.

Требования

Чтобы использовать эти функции, вы обязаны установить сервер БД FrontBase или как минимум клиентские библиотеки fbsql. Вы можете получить FrontBase по адресу https://www.frontbase.com/.

Установка

Чтобы иметь доступ к этим функциям, вы обязаны скомпилировать PHP с поддержкой fbsql путём использования опции --with-fbsql. Если вы используете эту опцию без специфицирования пути к fbsql, PHP ищет клиентские библиотеки fbsql в месте установки по умолчанию для данной платформы. Те, кто установил FrontBase в нестандартное место, должны всегда специфицировать путь к fbsql:--with-fbsql=/path/to/fbsql. Это заставит PHP использовать клиентские библиотеки, установленные FrontBase, и исключит конфликты.

Типы ресурсов

Предопределённые константы

Эти константы определены данным расширением и будут доступны только в том случае, если либо вкомпилированы в РНР, либо динамически загружены на этапе прогона.

FBSQL_ASSOC (integer)

FBSQL_NUM (integer)

FBSQL_BOTH (integer)

FBSQL_LOCK_DEFERRED (integer)

FBSQL_LOCK_OPTIMISTIC (integer)

FBSQL_LOCK_PESSIMISTIC (integer)

FBSQL_ISO_READ_UNCOMMITTED (integer)

FBSQL_ISO_READ_COMMITTED (integer)

FBSQL_ISO_REPEATABLE_READ (integer)

FBSQL_ISO_SERIALIZABLE (integer)

FBSQL_ISO_VERSIONED (integer)

FBSQL_UNKNOWN (integer)

FBSQL_STOPPED (integer)

FBSQL_STARTING (integer)

FBSQL_RUNNING (integer)

FBSQL_STOPPING (integer)

FBSQL_NOEXEC (integer)

FBSQL_LOB_DIRECT (integer)

FBSQL_LOB_HANDLE (integer)

Содержание

fbsql_affected_rows - получает количество рядов, задействованных в предыдущей операции FrontBase

fbsql_autocommit - включает или отключает autocommit (автоподтверждение транзакций)

fbsql_change_user - изменяет действующего пользователя активного соединения

fbsql_close - закрывает соединение с FrontBase

fbsql_commit - подтверждает транзакцию с БД

fbsql_connect - открывает соединение с FrontBase-сервером

fbsql_create_blob - создаёт BLOB

fbsql_create_clob - создаёт CLOB

fbsql_create_db - создаёт БД FrontBase

fbsql_data_seek - перемещает внутренний результирующий указатель

fbsql_database_password - устанавливает или запрашивает пароль для БД FrontBase

fbsql_database - получает или устанавливает имя БД, используемое в соединении

fbsql_db_query - отправляет FrontBase query/запрос

fbsql_db_status - получает статус данной БД

fbsql_drop_db - удаляет БД FrontBase

fbsql_errno — возвращает числовое значение сообщения об ошибке предыдущей операции FrontBase

fbsql_error — возвращает текст сообщения об ошибке предыдущей операции FrontBase

fbsql_fetch_array - извлекает результирующий ряд как ассоциативный массив, числовой массив, либо и тот, и другой

fbsql_fetch_assoc - извлекает результирующий ряд как ассоциативный массив

fbsql_fetch_field - получает информацию столбца из результата и возвращает её как объект

fbsql_fetch_lengths - получает длину каждого вывода в результате

fbsql_fetch_object - извлекает результирующий ряд как объект

fbsql_fetch_row - получает результирующий ряд как перечислимый массив

fbsql_field_flags - получает флаги, ассоциированные со специфицированным полем в результате

fbsql_field_len — возвращает длину специфицированного роля

fbsql_field_name - получает имя специфицированного поля в результате

fbsql_field_seek - устанавливает результирующий указатель на специфицированное смещение поля

fbsql_field_table - получает имя таблицы, в которой находится специфицированное поле

fbsql_field_type - получает тип специфицированного поля в результате

fbsql_free_result - освобождает результирующую память

fbsql_get_autostart_info - пока нет описания

fbsql_hostname - получает или устанавливает имя хоста, используемое в соединении

fbsql_insert_id - получает id, сгенерированный в предыдущей операции INSERT

fbsql_list_dbs - выводит список БД, доступных на FrontBase-сервере

fbsql_list_fields - выводит список результирующих полей FrontBase

fbsql_list_tables - выводит список таблиц в БД FrontBase

fbsql_next_result - перемещает внутренний результирующий указатель на следующий результат

fbsql_num_fields - получает количество полей в результате

fbsql_num_rows - получает количество рядов в результате

fbsql_password - получает или устанавливает user password, используемый в соединении

fbsql_pconnect - открывает постоянное соединение с FrontBase-сервером

fbsql_query - отправляет FrontBase query

fbsql_read_blob - читает BLOB из БД

fbsql_read_clob - читает CLOB из БД

fbsql_result - получает результирующие данные

fbsql_rollback - откатывает транзакцию в данной БД

fbsql_select_db - выбирает БД FrontBase

fbsql_set_lob_mode - устанавливает режим запрашивания LOB для результирующего набора FrontBase

fbsql_set_transaction - устанавливает блокировку и изоляцию транзакции

fbsql_start_db - стартует БД на локальном или удалённом сервере

fbsql_stop_db - останавливает БД на локальном или удалённом сервере

fbsql_tablename - получает табличное имя поля

fbsql_username - получает или устанавливает host user, используемого в соединении

fbsql_warnings - включает или отключает предупреждения FrontBase