XXI. Функции dbx

Введение

Модуль dbx это слой абстракции БД (db ’X’, где ’X’ это поддерживаемая БД). Функции dbx дают вам доступ ко всем поддерживаемым БД через использование простого соглашения по вызовам.
dbx-функции сами по себе являются не интерфейсом с БД, а интерфейсом с модулями, которые используются для поддержки этих БД.

Требования

Чтобы использовать БД с dbx-модулем, этот модуль обязан быть либо привязан, либо загружен в PHP, и модуль базы данных обязан поддерживаться этим dbx-модулем. В настоящее время поддерживаются следующие БД, а остальные - пока нет (надеюсь, это будет скоро):

• FrontBase (начиная с PHP 4.1.0)

• Microsoft SQL Server

• MySQL

• ODBC

• PostgreSQL

• Sybase-CT (начиная с PHP 4.2.0)

Документацию для добавления поддержки других БД в dbx можно найти по адресу: http://www.guidance.nl/php/dbx/doc/.

Установка

Для того чтобы эти функции стали доступны, вы обязаны скомпилировать РНР с опцией --enable-dbx и всеми опциями для баз данных, которые будут использоваться, например, для MySQL вы обязаны также специфицировать --with-mysql=[DIR]. Чтобы включить поддержку других БД в dbx-модуле, обратитесь к соответствующей документации по этим БД.

Конфигурация

Это расширение не определяет никаких директив конфигурации.

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

В dbx-модуле используются ресурсы двух типов. Первый - это link-object для соединения с БД, второй - result-object, содержащий результат выполнения запроса.

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

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

DBX_MYSQL (integer)

DBX_ODBC (integer)

DBX_PGSQL (integer)

DBX_MSSQL (integer)

DBX_FBSQL (integer)

DBX_OCI8 (integer)

DBX_SYBASECT (integer)

DBX_PERSISTENT (integer)

DBX_RESULT_INFO (integer)

DBX_RESULT_INDEX (integer)

DBX_RESULT_ASSOC (integer)

DBX_CMP_NATIVE (integer)

DBX_CMP_TEXT (integer)

DBX_CMP_NUMBER (integer)

DBX_CMP_ASC (integer)

DBX_CMP_DESC (integer)

Содержание

dbx_close - закрывает открытое соединение/БД

dbx_compare - сравнивает два ряда с целью сортировки

dbx_connect - открывает соединение/БД

dbx_error - выдаёт сообщение об ошибке в последнем вызове функции в модуле (а не просто в соединении)

dbx_query - отправляет запрос/query и получает все результаты (если имеются)

dbx_sort - сортирует результат из dbx_query специальной функцией сортировки