array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'uk', ), 'this' => array ( 0 => 'ref.pdo-odbc.php', 1 => 'ODBC and DB2 PDO Driver', 2 => 'ODBC and DB2 PDO Driver (PDO_ODBC)', ), 'up' => array ( 0 => 'pdo.drivers.php', 1 => 'PDO Drivers', ), 'prev' => array ( 0 => 'ref.pdo-oci.connection.php', 1 => 'PDO_OCI DSN', ), 'next' => array ( 0 => 'ref.pdo-odbc.connection.php', 1 => 'PDO_ODBC DSN', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/pdo_odbc/reference.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/ref.pdo-odbc.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

ODBC and DB2 PDO Driver (PDO_ODBC)

Вступ

PDO_ODBC is a driver that implements the PHP Data Objects (PDO) interface to enable access from PHP to databases through ODBC drivers or through the IBM DB2 Call Level Interface (DB2 CLI) library. PDO_ODBC currently supports three different "flavours" of database drivers:

ibm-db2

Supports access to IBM DB2 Universal Database, Cloudscape, and Apache Derby servers through the free DB2 express-C client.

unixODBC

Supports access to database servers through the unixODBC driver manager and the database's own ODBC drivers.

generic

Offers a compile option for ODBC driver managers that are not explicitly supported by PDO_ODBC.

On Windows, php_pdo_odbc.dll has to be enabled as extension in php.ini. It is linked against the Windows ODBC Driver Manager so that PHP can connect to any database cataloged as a System DSN.

Встановлення

PDO_ODBC on UNIX systems

  1. PDO_ODBC is included in the PHP source. You can compile the PDO_ODBC extension as either a static or shared module using the following configure commands.

    ibm_db2

    ./configure --with-pdo-odbc=ibm-db2,/opt/IBM/db2/V8.1/
    To build PDO_ODBC with the ibm-db2 flavour, you have to have previously installed the DB2 application development headers on the same machine on which you are compiling PDO_ODBC. The DB2 application development headers are an installable option in the DB2 servers, and are also available as part of the DB2 Application Development Client freely available for download from the IBM developerWorks » website.

    If you do not supply a location for the DB2 libraries and headers to the configure command, PDO_ODBC defaults to /home/db2inst1/sqllib.

    unixODBC

    ./configure --with-pdo-odbc=unixODBC,/usr/local
    If you do not supply a location for the unixODBC libraries and headers to the configure command, PDO_ODBC defaults to /usr/local.

    generic
    ./configure --with-pdo-odbc=generic,/usr/local,libname,ldflags,cflags

Попередньо визначені константи

Константи, описані нижче — визначені цим драйвером, тож доступні, коли розширення скомпільовано як частина PHP або динамічно підключене під час виконання. До того ж, ці спеціальні константи драйвера потрібно використовувати тільки для нього. Використання спеціальних атрибутів драйвера з іншим драйвером може спричинити неочікувану поведінку. Методом PDO::getAttribute() можна отримати атрибут PDO_ATTR_DRIVER_NAME, щоб перевірити сумісність коду для поточного драйвера з іншими драйверами.

PDO_ODBC_TYPE (string)

PDO::ODBC_ATTR_USE_CURSOR_LIBRARY (int)
Псевдонім Pdo\Odbc::ATTR_USE_CURSOR_LIBRARY.
PDO::ODBC_SQL_USE_IF_NEEDED (int)
Псевдонім Pdo\Odbc::SQL_USE_IF_NEEDED.
PDO::ODBC_SQL_USE_DRIVER (int)
Псевдонім Pdo\Odbc::SQL_USE_DRIVER.
PDO::ODBC_SQL_USE_ODBC (int)
Псевдонім Pdo\Odbc::SQL_USE_ODBC.
PDO::ODBC_ATTR_ASSUME_UTF8 (bool)
Псевдонім Pdo\Odbc::ATTR_ASSUME_UTF8.

Налаштування під час виконання

На поведінку цих функцій випливають налаштування в php.ini.

PDO_ODBC Configuration Options
Назва Початково Де можна змінювати Журнал змін
pdo_odbc.connection_pooling "strict" INI_ALL  
pdo_odbc.db2_instance_name NULL INI_SYSTEM Цей застарілий функціонал буде обов'язково видалено у майбутньому.
Докладніша інформація та визначення режимів INI_* на сторінці Де можна встановлювати параметри конфігурації.

Тут є коротке пояснення директив конфігурації.

pdo_odbc.connection_pooling string

Whether to pool ODBC connections. Can be one of "strict", "relaxed" or "off" (equals to ""). The parameter describes how strict the connection manager should be when matching connection parameters to existing pooled connections. strict is the recommend default, and will result in the use of cached connections only when all the connection parameters match exactly. relaxed will result in the use of cached connections when similar connection parameters are used. This can result in increased use of the cache, at the risk of bleeding connection information between (for example) virtual hosts.

This setting can only be changed from the php.ini file, and affects the entire process; any other modules loaded into the process that use the same ODBC libraries will be affected too, including the Unified ODBC extension.

Увага

relaxed matching should not be used on a shared server, for security reasons.

Підказка

Leave this setting at the default strict setting unless you have good reason to change it.

pdo_odbc.db2_instance_name string

If you compile PDO_ODBC using the db2 flavour, this setting sets the value of the DB2INSTANCE environment variable on Linux and UNIX operating systems to the specified name of the DB2 instance. This enables PDO_ODBC to resolve the location of the DB2 libraries and make cataloged connections to DB2 databases.

This setting can only be changed from the php.ini file, and affects the entire process; any other modules loaded into the process that use the same ODBC libraries will be affected too, including the Unified ODBC extension.

This setting has no effect on Windows.

Зміст