Руководство по PHP
Пред. |  | След.

# XXIV. dbx Functions

# Введение

The dbx module is a database abstraction layer (db 'X', where 'X' is a supported database). The dbx functions allow you to access all supported databases using a single calling convention. The dbx-functions themselves do not interface directly to the databases, but interface to the modules that are used to support these databases.

# Требования

To be able to use a database with the dbx-module, the module must be either linked or loaded into PHP, and the database module must be supported by the dbx-module. Currently, the following databases are supported, but others will follow:

- FrontBase (available from PHP 4.1.0).

- Microsoft SQL Server

- MySQL

- ODBC

- PostgreSQL

- Sybase-CT (available from PHP 4.2.0).

- Oracle (oci8) (available from PHP 4.3.0).

- SQLite (PHP 5).

Documentation for adding additional database support to dbx can be found at http://www.guidance.nl/php/dbx/doc/.

# Установка

In order to have these functions available, you must compile PHP with dbx support by using the --enable-dbx option and all options for the databases that will be used, e.g. for MySQL you must also specify --with-mysql=[DIR]. To get other supported databases to work with the dbx-module refer to their specific documentation.

# Настройка во время выполнения

Поведение этих функций зависит от установок в `php.ini`.

Таблица 1. DBX Configuration Options

Name | Default | Changeable | Changelog
--- | --- | --- | ---
dbx.colnames_case | "unchanged" | PHP_INI_SYSTEM | Available since PHP 4.3.0.

Для подробного описания констант PHP_INI_*, обратитесь к документации функции ini_set().

> Замечание: This ini-option is available available from PHP 4.3.0.

Краткое разъяснение конфигурационных директив.

dbx.colnames_case string

  Columns names can be returned "unchanged" or converted to "uppercase" or "lowercase". This directive can be overridden with a flag to dbx_query().

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

There are two resource types used in the dbx module. The first one is the link-object for a database connection, the second a result-object which holds the result of a query.

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

Перечисленные ниже константы определены данным расширением и могут быть доступны только в том случае, если PHP был собран с поддержкой этого расширения или же в том случае, если данное расширение подгружается во время выполнения.

`DBX_MYSQL` (integer)

`DBX_ODBC` (integer)

`DBX_PGSQL` (integer)

`DBX_MSSQL` (integer)

`DBX_FBSQL` (integer)

`DBX_OCI8` (integer) (available from PHP 4.3.0)

`DBX_SYBASECT` (integer)

`DBX_SQLITE` (integer) (PHP 5)

`DBX_PERSISTENT` (integer)

`DBX_RESULT_INFO` (integer)

`DBX_RESULT_INDEX` (integer)

`DBX_RESULT_ASSOC` (integer)

`DBX_RESULT_UNBUFFERED` (integer) (PHP 5)

`DBX_COLNAMES_UNCHANGED` (integer) (available from PHP 4.3.0)

`DBX_COLNAMES_UPPERCASE` (integer) (available from PHP 4.3.0)

`DBX_COLNAMES_LOWERCASE` (integer) (available from PHP 4.3.0)

`DBX_CMP_NATIVE` (integer)

`DBX_CMP_TEXT` (integer)

`DBX_CMP_NUMBER` (integer)

`DBX_CMP_ASC` (integer)

`DBX_CMP_DESC` (integer)

Пред. | Начало | След.
dbplus_xunlockrel | Уровень выше | dbx_close